Skills

A skill is a Markdown file an agent loads when a job matches its description. Each skill lives in skills/<name>/SKILL.md, and each one has a page here with the same text. Point your agent harness at the skills/ folder to load them.

Skill	Use it to
add-a-capability	Add one action to an app as a capability. Define its contract with a permission, implement the handler on a module’s service, call it from delivery, and test the gates and the typed errors.
add-an-effect-module	Add one Effect module as a workspace package and carry it through a use-case and a delivery handler in an app without breaking the workspace or layer rules.
add-an-mcp-tool	Expose an existing use-case to agents as an MCP tool, and set up the MCP adapter in an app the first time, with OAuth, a small tool catalogue, and the tests that prove access holds.
learn-house-rules	Find your way around house-rules or a repo made from its template. Where the law, the words, the rules and the docs site are, and the order to read them in before you change code.
write-a-docs-page	Add or change a page on the house-rules docs site in site/. Decide whether the page is hand-written or generated, place it, link it by relative path, and prove the build, the llms files and the checks.