Skip to main content
ClaudeWave
Skill377 estrellas del repoactualizado 2d ago

docs-governance

The docs-governance skill standardizes Markdown documentation placement and structure within the clawdotnet/openclaw.net repository. Use it when creating, moving, or reorganizing documentation files to ensure product and technical docs go into the `docs/` directory, standard repository meta files remain at the root, specialized tooling files stay in their expected locations, and all affected links and README references are updated accordingly.

Instalar en Claude Code
Copiar
git clone --depth 1 https://github.com/clawdotnet/openclaw.net /tmp/docs-governance && cp -r /tmp/docs-governance/.github/skills/docs-governance ~/.claude/skills/docs-governance
Después abre una sesión nueva de Claude Code; el skill carga automáticamente.

SKILL.md

Use this skill when creating, moving, or reorganizing Markdown documentation in this repository.

1. Documentation placement rules
   - Put product, setup, architecture, operations, compatibility, roadmap, and engineering notes in `docs/`.
   - Keep repository-standard meta files at the repo root only when the platform or community expects them there: `README.md`, `CHANGELOG.md`, `SECURITY.md`, `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`, and `LICENSE`.
   - Keep Copilot and agent customization files where the tooling expects them: `AGENTS.md`, `.github/copilot-instructions.md`, and `.github/skills/**/SKILL.md`.
   - Keep shipped OpenClaw runtime skills under `src/OpenClaw.Gateway/skills/<skill>/SKILL.md`; do not move those into `docs/`.

2. Naming and structure rules
   - Prefer `docs/<topic>.md` with descriptive kebab-case names for new documentation.
   - If a topic grows, create a focused subfolder under `docs/` rather than adding more root Markdown files.
   - Do not add general documentation to the repository root.

3. Change rules
   - When moving or adding docs, update relative links in the same change.
   - Update README quick links when the document is user-facing or operationally important.
   - Do not move issue templates, pull request templates, licenses, or any `SKILL.md` files unless the task is specifically about those systems.

4. Default behavior
   - If a new Markdown document is requested and no location is specified, place it in `docs/`.
   - If a document mixes repository policy and product guidance, keep the policy file in its standard root location and move the product guidance into `docs/`.