Build and evaluate a skill

How to build and evaluate a skill

A walkthrough of the core loop: create a skill, evaluate it, improve it.

flowchart LR
  C["1. Create<br/>askit-build-skill (create)<br/>scaffolds SKILL.md from template"] --> E["2. Evaluate<br/>node scripts/evaluate.mjs<br/>per-rule findings + tier"]
  E --> I["3. Improve<br/>askit-build-skill (improve)<br/>fixes what evaluate flagged"]
  I --> E
  E -->|0 errors| D["Done: a conformant skill"]

1. Create

Invoke askit-build-skill (create mode). It asks for the name, what the skill does, when to use it, and trigger keywords, then scaffolds skills/<name>/SKILL.md from the template (templates/SKILL.md).

2. Evaluate

Run the assessment:

node scripts/evaluate.mjs skills/<name>

You get per-rule findings, and - for a whole plugin - the tier and what blocks the next one. A single skill directory is assessed at the component level (the skill-applicable rules only; no tier, since a lone component has no manifest).

3. Improve

Invoke askit-build-skill (improve mode). It reads the evaluate report and fixes what it flags - tightening the description, adding samples, or moving depth into references/.

Repeat evaluate until the report is clean (0 error(s)).

See also

• askit-evaluate reference
• askit-build-skill reference
• Conformance and tiers