# Iii Skill Authoring

> Skill bundle index for authoring the partials iii-skill-check renders into a worker README and a single skill.md (leaves inlined as HOWTOs).

- Skill: `iii-hq/iii-skill-authoring` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add iii-hq/iii-skill-authoring`
- Raw SKILL.md: https://api.skillmd.com/api/skills/iii-hq/iii-skill-authoring/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: iii-hq (https://skillmd.com/u/iii-hq)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/iii-hq/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:

```yaml
# 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`](./structure.md): directory layout, slot order, what each file feeds.
- [`voice`](./voice.md): voice rules distilled from `project-rules/voice.md` and the slop-token lists.
- [`quickstart`](./quickstart.md): what makes a good `## Quickstart` section.
- [`leaves`](./leaves.md): what goes in `docs/leaves/<leaf>.md`.
- [`llm-only-blocks`](./llm-only-blocks.md): when to wrap content in llm-only comment markers.
- [`skeleton`](./skeleton.md): copy-paste starter for a brand-new worker.
- [`check`](./check.md): 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.