skill-authoring

Installation
SKILL.md

Skill Authoring

Skills are on-demand methodology. They do not create permissions, orchestration, approval stages, or evidence merely by being loaded. Any agent may use them within the task and host instructions.

Three-layer skill contract

A skill directory may contain three distinct context layers:

  • SKILL.md — required practitioner methodology: how to do the work well.
  • ASSESSMENT.md — optional review methodology: how to check conformance and domain correctness.
  • QA.md — optional adversarial-validation methodology: how to falsify confidence after competent production and review.

The three files must not become increasingly severe copies of the same checklist.

SKILL.md ownership

Keep producer/practitioner method here.

Keep optional conformance rubrics and adversarial attack plans in their companions rather than mixing them into practitioner guidance. Keep the checks and failure handling needed to produce sound ordinary work in SKILL.md; moving them into an optional companion would make the practitioner path incomplete.

Installs
9
Repository
bateau84/skills
First Seen
13 days ago