jarvis-doc-author

Solid

Authoritative skill for writing internal Personal-Jarvis docs under ``docs/`` and sibling directories. Enforces a Diataxis-compliant classification (concept/how-to/tutorial/reference/troubleshooting/adr), a uniform YAML frontmatter schema, a style canon (active voice, imperative instructions, English prose), and hard anti-patterns (no quadrant mixing, no filler intros, no "Click here"). Use when writing or fundamentally reworking any Markdown doc under ``docs/``.

AI & Automation 41 stars 17 forks Updated today Apache-2.0

Install

View on GitHub

Quality Score: 82/100

Stars 20%
54
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Jarvis Doc Author When a Jarvis doc is written, the rule is: **classify first, then structure, then phrase, then self-check.** Not the other way around. This skill provides the scaffolding. It does not replace thinking — it enforces the discipline that separates a pile of internal Markdown files from a *real* doc layer (role models: Kubernetes doc site, Docker manuals, GitHub Docs). ## When to trigger Activate this skill when the user (via voice or chat) or a Sub-Jarvis explicitly or implicitly wants to write a **new doc** or **structurally** rework an existing doc. Concrete examples: - "Schreib ein Doc ueber den BrainManager-Routing-Discipline-Mechanismus." (Write a doc about the BrainManager routing discipline mechanism.) - "Leg ein ADR an fuer die Sub-Jarvis-Hard-Cap-Entscheidung." (Create an ADR for the Sub-Jarvis hard-cap decision.) - "Dokumentiere wie man einen neuen Brain-Provider hinzufuegt." (Document how to add a new brain provider.) - "Fass die Phase-6-Ergebnisse als Test-Report zusammen." (Summarize the Phase 6 results as a test report.) - "Mach mir eine How-To fuer das Voice-Bridge-Setup." (Create a how-to for the voice-bridge setup.) - A Sub-Jarvis receives the task from the main Jarvis "schreib das in ``docs/...`` rein" (write this into ``docs/...``) — then the Sub-Jarvis consults this skill before writing. Do NOT trigger on: - Code comments, docstrings, type hints — those follow the CLAUDE.md rule (code identifiers in English), but need no doc s...

Details

Author
PersonalJarvis
Repository
PersonalJarvis/PersonalJarvis
Created
3 months ago
Last Updated
today
Language
Python
License
Apache-2.0

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category