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 68 stars 26 forks Updated today Apache-2.0

Install

View on GitHub

Quality Score: 85/100

Stars 20%
61
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

AI & Automation Solid

skill-creator

Creates new Jarvis skills and iteratively improves existing ones. Activates when the user wants to build a new skill ("erstell einen skill fuer X" / "create a skill for X" / "mach aus diesem Workflow einen Skill"). No auto voice trigger — the Supervisor dispatches this skill on an intent basis.

68 Updated today
PersonalJarvis
AI & Automation Listed

doc-standards

Documentation writing-quality standards — controlled language (ASD-STE100), Google/Microsoft style guide rules, ISO 24495 plain language, AI/agent readability (llms.txt, self-contained sections), and a machine-checkable lint gate. Use whenever writing or reviewing ANY documentation prose — README, API reference, tutorial, how-to, changelog, error message, code comment blocks, llms.txt — even if the user only says "write docs", "document this", "improve the README", "docs smell like AI", or "make the docs clearer". Structure/coverage questions (which doc types exist) belong to a Diátaxis-structure skill if one is installed; THIS skill governs how each sentence and section is written, and provides the lint gate to verify it.

17 Updated 2 months ago
JuanMarchetto
Code & Development Listed

ai-doc

Use when creating or fixing an AI-facing doc/rule/skill/agent in this repo (SKILL.md, .claude/rules/*, agents/*, CLAUDE.md, AGENTS.md) — to apply the project's context-hygiene + rule-as-test + AI-agnostic authoring standard. Triggers: write a rule, author a skill, fix a doc, doc-authority header, progressive disclosure, channel selection, документация, правило, скилл.

1 Updated today
artyhoo