distilly-doc-standards

Featured

Use when writing, moving, or reviewing documentation on the distilly branch — choosing which file owns a fact, adding Agent Notes, or responding to verify_agent_notes failures.

AI & Automation 23,942 stars 2108 forks Updated today MIT

Install

View on GitHub

Quality Score: 91/100

Stars 20%

100

Recency 20%

100

Frontmatter 20%

Documentation 15%

Issue Health 10%

License 10%

100

Description 5%

100

Skill Content

# distilly documentation workflow Contracts live in [docs/AGENTS.md](../../../docs/AGENTS.md). This skill is the walk, not a second standard. 1. Name the document's subject and its direct children. Keep full detail only for the subject. 2. Choose the folder: product contract → `docs/design/`; live tree → `architecture.md`; steps → `cookbook/`; review rules → `docs/process/`; why → Agent Note. 3. Do not compress [system-v1.md](../../../docs/design/system-v1.md) into architecture.md. Edit the parent design file first, then the matching `docs/design/v1/` chapter. 4. Search `.agents/notes/` before adding a note. Update the owner or cross-link. 5. Run `python3 scripts/verify_agent_notes.py` after note or standing-doc edits. 6. Standing docs stay present tense. The design corpus may keep conversation density.

Details

Author: titanwings
Repository: titanwings/colleague-skill
Created: 4 months ago
Last Updated: today
Language: Python
License: MIT

Similar Skills

Semantically similar based on skill content — not just same category

Data & Documents Featured

dsh-doc-standards

Use when writing, moving, reviewing, or auditing documentation in the deepseek-harness repo — choosing hierarchy and detail, separating tutorials from references, checking tutorial progression, trimming doc slop, responding to a verify-doc-budgets failure, or requests like "improve the docs", "audit the docs", "where should this be documented", or "this doc is too long".

365 Updated today

text2future

AI & Automation Listed

agent-docs-writing

Use when reading, creating, or updating agent documentation, module docs, roadmaps, or AGENTS.md. Understands the full .augment/, agents/, and copilot-instructions structure.

7 Updated today

event4u-app

AI & Automation Listed

writing-project-docs

The standard a project's agent-facing docs follow — which file owns what, plus a worked example of each.

0 Updated 1 weeks ago

hk9890