Agent-Skills.md

Agent Skills: Doc Writer Skill

Create or update numbered task docs using repo context, DOC_TEMPLATE.md, and naming conventions.

UncategorizedID: aiskillstore/marketplace/doc-writer

Repository

aiskillstore/marketplace
aiskillstore
23014

Install this agent skill to your local

pnpm dlx add-skill https://github.com/aiskillstore/marketplace/tree/HEAD/skills/0xhiroki/doc-writer

Skill Files

Browse the full folder contents for doc-writer.

Download Skill

Loading file tree…

skills/0xhiroki/doc-writer/SKILL.md

Skill Metadata

Name
doc-writer
Description
Create or update numbered task docs using repo context, DOC_TEMPLATE.md, and naming conventions.

Doc Writer Skill

Purpose

Generate or refresh docs/planned/XX-*.md and docs/completed/XX-*.md files using the mandated template (docs/DOC_TEMPLATE.md) and existing repository content.

Instructions

  1. Inspect relevant source material:
    • Read docs/DOC_TEMPLATE.md for structure expectations.
    • Gather context from PLAN.md, AGENTS.md, and any existing task doc being updated.
    • When creating a new task, identify prior numbering and ensure a unique two-digit prefix.
  2. Draft the document following exact sections: metadata block, Objective, Prerequisites / Dependencies, Implementation Steps, Validation, Completion Criteria, Notes / Follow-ups.
  3. Reference existing code or documentation by linking relative paths rather than duplicating large excerpts.
  4. Confirm acceptance criteria reflect the latest repository state (tests, tooling, env requirements).
  5. Save the file under the correct directory (docs/planned/ or docs/completed/) with the naming convention NN-task-name.md.
  6. Run required validators (lint/tests) if file changes mandate repository updates; record commands executed.
  7. Summarize the edits in the PR/task notes.

Verification

  • Ensure the new/updated doc passes markdown lint (if configured) and adheres to docs/DOC_TEMPLATE.md structure.
  • Confirm numbering sequence remains unique.