---
name: wataru-maeda-manage-docs
description: "Create or update README files, AGENTS.md rules, and skills from actual code. Use before editing any README.md, AGENTS.md, or skill, or when condensing them."
license: "MIT"
metadata:
  decimalai-skill-id: "916ad5fd-c29e-42ec-b487-41265d9f8f4d"
  decimalai-version-id: "148ec9b1-cc66-4b12-80f4-ad01c6a99480"
  decimalai-version: "1"
  decimalai-body-sha256: "c440bef838ee7f1aa5b16f8236962d3a1061a7eb1526e116fb7ae3676cadff6e"
  decimalai-name: "wataru-maeda/manage-docs"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "documentation"
  decimalai-source: "https://app.decimal.ai/s/wataru-maeda-manage-docs@1/SKILL.md"
---
# Manage Docs

Write docs a developer or agent can follow without guessing.

## Actions

| Target                      | Read                   |
| --------------------------- | ---------------------- |
| `README.md`                 | [readme.md](readme.md) |
| `AGENTS.md` and `CLAUDE.md` | [rules.md](rules.md)   |
| Skills in `.agents/skills`  | [skills.md](skills.md) |

## Process

1. Read the target, its parent rules, and the code behind each claim. Never print secret values.
2. Show the proposed text before writing unless edits are authorized.
3. Ask one open question at a time: background, recommendation, then options. Ask in plain text.
4. Write the approved version. Do not ask again after approval.

Do not run deployment, secret upload, or build commands merely to document them.
Do not commit or push unless requested.

## Writing

- Write direct orders. Give each sentence one instruction. Put important rules first.
- Keep lists to five items. Split longer lists by purpose. Number steps when order matters.
- Copy commands, paths, and names from the code. State each command's working directory.
- Link to the owner of a rule or procedure. Never copy it.
- Remove filler, repeated summaries, and unverified claims.

## Verify

- Check links, heading anchors, commands, and paths against the repository.
- Run the formatter check on edited files.
- Check the diff for unrelated edits, lost constraints, and exposed secrets.
- Report only checks actually run.