{
  "markdown": "# Doc Steward\n\n[中文说明](README.zh-CN.md)\n\nDoc Steward is a focused Agent Skill for keeping project documentation accurate after meaningful code, API, setup, architecture, and operations changes.\n\nIt is designed for coding agents that already work inside a repository and need a lightweight, production-friendly way to decide when docs should change, which docs should change, and when leaving docs alone is the right call.\n\n## Quickstart\n\nInstall the plugin or copy the skill into your agent's skills directory, then add this instruction to your project-level agent guidance:\n\n```md\nUse the `documentation` skill before completing tasks that may change public behavior, APIs, CLI commands, configuration, setup, architecture, deployment, operations, or durable project decisions.\n```\n\nThe skill will not try to rewrite your whole documentation set. It checks whether the current task affects documentation, updates only the relevant files, and explicitly reports when no documentation changes were needed.\n\n## How It Works\n\nThe skill asks three questions before a task is finished:\n\n1. Did an interface change? Public behavior, APIs, routes, CLI commands, config, env vars, schemas, file formats, installation, or usage.\n2. Did structure change? Architecture, module responsibilities, dependency boundaries, deployment, operations, or contributor workflow.\n3. Did project knowledge change? Durable decisions, tradeoffs, limitations, or technical debt that future maintainers should know.\n\nIf the answer is yes, the agent updates the smallest relevant documentation surface. If the answer is no, the agent leaves docs alone and says so.\n\n## Installation\n\nInstallation differs by agent host. If you use more than one host, install the plugin separately for each one.\n\n### Codex\n\nThis repository includes Codex plugin metadata at `.codex-plugin/plugin.json`.\n\nAfter publishing the repository, install it through your Codex plugin workflow or copy the skill directly:\n\n```txt\n$CODEX_HOME/skills/documentation/\n```\n\nIf `CODEX_HOME` is not set, use the default Codex skills directory for your system.\n\n### Claude Code\n\nThis repository includes Claude plugin metadata at `.claude-plugin/plugin.json`.\n\nInstall from your GitHub repository when your Claude Code environment supports repository plugins, or copy `skills/documentation/` into your Claude skills directory.\n\n### Cursor\n\nThis repository includes Cursor plugin metadata at `.cursor-plugin/plugin.json`.\n\nThe manifest points Cursor at:\n\n```txt\n./skills/\n```\n\n### Gemini CLI\n\nThis repository includes:\n\n```txt\ngemini-extension.json\nGEMINI.md\n```\n\n`GEMINI.md` loads the `documentation` skill directly:\n\n```md\n@./skills/documentation/SKILL.md\n```\n\n### OpenCode\n\nThis repository includes an OpenCode plugin entrypoint:\n\n```txt\npackage.json\n.opencode/plugins/doc-steward.js\n.opencode/INSTALL.md\n```\n\nFor a published repository, add this to your `opencode.json`:\n\n```json\n{\n  \"plugin\": [\"doc-steward@git+https://github.com/MangMax/doc-steward.git\"]\n}\n```\n\nFor local testing, point OpenCode at this repository path. See `.opencode/INSTALL.md` for details.\n\n### Project-Local Skill\n\nFor any host that supports local skills, copy the skill directory into your project:\n\n```txt\nyour-project/\n└── skills/\n    └── documentation/\n        ├── SKILL.md\n        ├── agents/\n        └── references/\n```\n\n## What It Updates\n\nThe skill is intentionally conservative. It favors surgical edits over broad rewrites and avoids documentation churn for internal-only or mechanical changes.\n\nTypical updates include:\n\n- README quickstart, setup, usage, or documentation index changes\n- Reference docs for public APIs, CLI commands, config, env vars, schemas, file formats, and errors\n- Architecture docs when module boundaries, dependencies, or data flow change\n- Changelog or release notes for user-visible releases, breaking changes, and deprecations\n- ADRs only for durable decisions with meaningful tradeoffs\n- Playbooks for repeatable operational or maintenance procedures\n- Agent guidance when repository-specific agent rules already exist or are explicitly requested\n\n## What's Inside\n\n```txt\n.claude-plugin/\n└── plugin.json\n.codex-plugin/\n└── plugin.json\n.cursor-plugin/\n└── plugin.json\n.github/\n└── PULL_REQUEST_TEMPLATE.md\n.opencode/\n├── INSTALL.md\n└── plugins/\n    └── doc-steward.js\nAGENTS.md\nCLAUDE.md\ngemini-extension.json\nGEMINI.md\nLICENSE\npackage.json\nRELEASE-NOTES.md\nskills/documentation/\n├── SKILL.md\n├── agents/openai.yaml\n└── references/\n    ├── adr.md\n    ├── bootstrap.md\n    ├── document-map.md\n    └── templates.md\n```\n\n`SKILL.md` contains the core workflow and guardrails. The `references/` files are loaded only when the agent needs more detail, keeping the main skill lightweight.\n\n## Design Principles\n\n- Evidence over invention: documentation must come from code, config, tests, examples, release metadata, existing docs, or explicit user instructions.\n- Smallest useful edit: update the narrowest documentation surface that keeps the project accurate.\n- No empty docs: do not create placeholder files, blank sections, blank tables, or speculative roadmap items.\n- Respect existing structure: preserve the project's current documentation style when it is coherent.\n- Production safety: do not document secrets, private credentials, internal tokens, or sensitive customer data.\n\n## Validation\n\nSanity-check JSON manifests before publishing:\n\n```sh\npython -m json.tool .codex-plugin/plugin.json\npython -m json.tool .claude-plugin/plugin.json\npython -m json.tool .cursor-plugin/plugin.json\npython -m json.tool gemini-extension.json\npython -m json.tool package.json\n```\n\n## Publishing Checklist\n\nBefore publishing this repository to GitHub:\n\n- Confirm the GitHub URL in `.opencode/INSTALL.md`, `.codex-plugin/plugin.json`, and `package.json` is current.\n- Install in at least one target host and confirm the `documentation` skill is discovered.\n- Run the validation commands above.\n- Create a git tag that matches the release notes, for example `v0.1.0`.\n\n## License\n\nMIT License. See [LICENSE](LICENSE).\n",
  "bytes": 6054,
  "sha": "78c0540a2b2f044581e1e2059c7de352e7003f57ee82d59236fefe0413bd2bf7",
  "repo_slug": "mangmax/doc-steward",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_mangmax_doc_steward_ee8774fd/readme"
}