Iii Skill Authoring

iii-skill-authoring

How to write the partials that iii-skill-check renders into the README and the single skill.md of an iii worker (per-function leaves are inlined under ## Additional HOWTOs).

Read individual topics directly via skillkit read iii-skill-authoring/<topic>, install the bundle into a consumer repo with npx skillkit add iii-hq/skills-and-validation/content/skills, or surface it through the iii engine by adding the path to your deployment's skills: glob:

# config.yaml for the iii engine (typically at the engine project root)
skills:
  - ~/.local/share/skill-check/current/content/skills/iii-skill-authoring/**/*.md

Topics

• structure: directory layout, slot order, what each file feeds.
• voice: voice rules distilled from project-rules/voice.md and the slop-token lists.
• quickstart: what makes a good ## Quickstart section.
• leaves: what goes in docs/leaves/<leaf>.md.
• llm-only-blocks: when to wrap content in llm-only comment markers.
• skeleton: copy-paste starter for a brand-new worker.
• check: running iii-skill-check locally and reading its output.

Function-level API surface (signatures, descriptions, payload schemas) is generated by a separate auto-gen system. This bundle covers the narrative layer only.

This bundle is not itself a worker. There is no iii.worker.yaml, no Rust source, no iii-skill-render step. The markdown files in this directory are the source of truth.