# For AI agents `denote` ships artifacts for coding agents alongside its code. This page lists them, says where each lives in the repository, and points at the machine-readable copies of this documentation. ## Skills Skills are folders holding a `SKILL.md` (the [Agent Skills](https://agentskills.io) format): a description that tells an agent when to use it and a body with the procedure. Install one into your agent with `gh skill` (any host: `--agent claude-code`, `copilot`, `cursor`, `codex`, `gemini`), or use the copy bundled in the wheel. ### `opsward` Run opsward to assess and improve this project’s AI agent setup. Use when the user says ‘opsward’, ‘check my setup’, ‘improve my AI config’, or wants a full audit and remediation. Source: [`.claude/skills/opsward`](https://github.com/thorwhalen/denote/tree/HEAD/.claude/skills/opsward). ### `opsward-diagnose` Diagnose the health of this project’s AI agent setup. Use when the user asks to check, audit, or score the project’s CLAUDE.md, skills, docs, or agent configuration. Source: [`.claude/skills/opsward-diagnose`](https://github.com/thorwhalen/denote/tree/HEAD/.claude/skills/opsward-diagnose). ### `opsward-generate` Generate missing AI setup artifacts for this project. Use when the user asks to scaffold, create, or bootstrap CLAUDE.md, docs, skills, or agent configuration. Source: [`.claude/skills/opsward-generate`](https://github.com/thorwhalen/denote/tree/HEAD/.claude/skills/opsward-generate). ### `opsward-maintain` Check documentation and AI setup for staleness, drift, or inconsistency. Use when the user asks to maintain, refresh, or update project docs and AI configuration. Source: [`.claude/skills/opsward-maintain`](https://github.com/thorwhalen/denote/tree/HEAD/.claude/skills/opsward-maintain). ## Subagents Subagents are Markdown files with a frontmatter (`name`, `description`, `tools`) and a system prompt as the body. Copy one into your project’s `.claude/agents/` (or your agent host’s equivalent) to delegate the task it describes. ### `setup-auditor` Read-only diagnostic agent that audits the project’s AI setup (CLAUDE.md, skills, docs, rules). Use when you want to check the health of the project’s agent configuration without making changes. Source: [`.claude/agents/setup-auditor.md`](https://github.com/thorwhalen/denote/tree/HEAD/.claude/agents/setup-auditor.md). ## Instruction files Files agents read before working in this repository. - [`CLAUDE.md`](https://github.com/thorwhalen/denote/tree/HEAD/CLAUDE.md): read by Claude Code ## Machine-readable documentation This site publishes the same documentation in forms that fit an agent’s context window: - [`llms.txt`](https://thorwhalen.github.io/denote/llms.txt): an index of every page with a one-line description ([llms.txt](https://llmstxt.org) format) - [`denote.md`](https://thorwhalen.github.io/denote/denote.md): the whole documentation as one Markdown file - `.html.md`: a rendered Markdown twin of every page, advertised from each page’s `` with `` - [`objects.inv`](https://thorwhalen.github.io/denote/objects.inv): the Sphinx inventory: a symbol-to-URL index (`sphobjinv convert plain objects.inv -`)