Minimal Capability

Minimal Capability Fixture

This fixture exercises the bare-minimum required v8-compatible frontmatter. It contains only the required fields, the recommended stability + license fields, and the four capability-archetype body sections.

Concept of the skill

What it is: A capability skill is a unit of reusable agent guidance described by v8-compatible frontmatter plus a small set of body sections. Mental model: Frontmatter is the routing contract; the body is the teaching content the agent applies. Why it exists: To prove the smallest conformant skill still lints, compiles into the manifest, and routes. What it is NOT: It is not a grounded, relation-rich, or comprehension-graded skill — those are exercised by the sibling fixtures. Adjacent concepts: the with-grounding, with-relations, and comprehension-full fixtures. One-line analogy: It is the "hello world" of the skill contract. Common misconception: That a minimal skill may omit the skill-content body sections — it may not; the five are required.

Coverage

The required v8 frontmatter fields, plus stability and license. No optional relations, no grounding, no Understanding fields, no Audit Status.

Philosophy of the skill

The simplest possible v8-compatible skill should still pass lint. If this fixture ever starts failing lint without a deliberate schema change, the lint check has regressed or grown a new required field that this fixture should adopt together with the canonical library.

Verification

node scripts/skill-lint.js --path examples/fixture-skills/minimal-capability
# expected: 0 errors

Do NOT Use When

• You need to exercise codebase grounding — see the with-grounding planned fixture in ../README.md.
• You need to exercise typed relations — see the with-relations planned fixture in ../README.md.
• You need to exercise flat Understanding fields or the Audit Status — see the comprehension-full planned fixture in ../README.md.
• You need a real production-grade authoring example — use a canonical skill from skills/.