Agent skill

context:atomic-doc

Create/update atomic documentation (blocks, foundations, stacks). Use when user asks to "create atomic doc", "add a block", "add a foundation", "setup a stack", or needs to document reusable knowledge. Creates files in context/ following SWEBOK-aligned structure.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/context-atomic-doc

SKILL.md

Atomic Documentation

Create or update context documentation following the atomic documentation system.

Execution Instructions

When this skill is invoked:

MANDATORY FIRST STEP: Use the Read tool to read context/workflows/manage-atomic-doc.md (relative to project root). DO NOT proceed without reading this file first - it contains the complete workflow including Phase 0 (index check) that you MUST follow.

After reading the workflow file:

  1. Parse $ARGUMENTS:

    • create <layer>/<domain>/<name> → new doc
    • update <path> → modify existing
    • No args → ask user what they want to create/update
  2. Follow ALL phases in the workflow file, starting with Phase 0.

Quick Reference

Layer Purpose Examples
blocks Single units of knowledge (tool-centric) bun.md, eslint.md, vitest.md
foundations Capabilities (combines blocks) exec-tsx.md, test-unit-vitest.md
stacks Complete project setups cli-bun.md, api-pnpm-fastify.md
Domain SWEBOK Area What It Covers
construct Software Construction Build, bundle, package
test Software Testing Unit, E2E, coverage
quality Software Quality Lint, format, style
security Software Security Auth, secrets, hardening
scm Config Management Version, release, publish
ops SE Operations CI/CD, deploy, infra
observe Operations (sub-area) Log, trace, metrics
docs Architecture & Design ADRs, diagrams, prompting

Usage

/context:atomic-doc create blocks/test/playwright.md
/context:atomic-doc create foundations/construct/bundle-web-esbuild.md
/context:atomic-doc update context/blocks/construct/bun.md

References

  • Full workflow: @context/workflows/manage-atomic-doc.md
  • Philosophy & naming: @context/blocks/docs/atomic-documentation.md
  • Maintenance patterns: @context/blocks/docs/maintenance.md
  • Index of all docs: @context/README.md

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results