Extension Assessment Skill

Systematic TYPO3 extension assessment against all Netresearch skills with checkpoint-based verification - by Netresearch.

Why This Skill Exists

When asked to "ensure extension aligns with all skills", LLMs typically:

• Cherry-pick obvious issues (satisficing)
• Miss 50-80% of requirements
• Report "done" without exhaustive verification

This skill enforces systematic verification through:

1. Scripted pre-flight checks (mechanical, 100% accurate)
2. Domain-batched LLM agents (subjective judgment)
3. Structured JSON output (verifiable completeness)

Installation

Via Netresearch Marketplace (Recommended)

claude plugins:install netresearch/extension-assessment-skill

Via Composer

composer require netresearch/agent-extension-assessment

Usage

Run Assessment

/assess-extension

This will:

1. Detect extension root (ext_emconf.php or composer.json with typo3-cms-extension)
2. Discover all skills with checkpoints
3. Run scripted mechanical checks
4. Spawn domain-batched LLM agents for subjective reviews
5. Generate compliance report

Run Checkpoints Manually

scripts/run-checkpoints.sh <checkpoints.yaml> <project-root>

Adding Checkpoints to Skills

Create checkpoints.yaml in your skill's root directory:

version: 1
skill_id: my-skill

mechanical:
  - id: MS-01
    type: file_exists
    target: README.md
    severity: error
    desc: "README.md must exist"

llm_reviews:
  - id: MS-10
    domain: repo-health
    prompt: "Verify README structure follows standards"
    severity: warning
    desc: "README should have standard sections"

See skills/extension-assessment/references/checkpoints-schema.md for full schema documentation.

Checkpoint Types

Type	Description
file_exists	File must exist
file_not_exists	File must NOT exist
contains	File contains literal string
regex	File matches regex pattern
json_path	JSON path exists (jq)
command	Command exits with 0
llm_review	Requires LLM judgment

Domain Groups

Domain	Focus
repo-health	README, badges, branding, AGENTS.md
security	SLSA, OpenSSF, SBOM, vulnerabilities
code-quality	PHPStan, tests, PHP patterns
documentation	RST, docs.typo3.org standards

Example Assessment Output

{
  "extension": "netresearch/contexts",
  "overall_status": "FAIL",
  "summary": {
    "total": 45,
    "pass": 38,
    "fail": 5,
    "skip": 2
  },
  "checkpoints": [
    {"id": "GH-01", "status": "pass", "evidence": "README.md exists"},
    {"id": "ER-04", "status": "fail", "evidence": "Missing OpenSSF badge"}
  ]
}

Assets

• assets/github-project-checkpoints.yaml - Example checkpoints for github-project skill
• assets/enterprise-readiness-checkpoints.yaml - Example checkpoints for enterprise-readiness skill
• assets/llm-rubric-repo-health.md - LLM review rubrics for repo-health domain
• assets/skill-template/ - Template for creating new skills with checkpoints

References

• references/checkpoints-schema.md - Full schema documentation
• references/migration-guide.md - How to add checkpoints to existing skills

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

License

MIT License - see LICENSE for details.

---

Netresearch DTT GmbH - netresearch.de