Add documentation-docusaurus agent skill

Packages generic-documentation-v1 as documentation-docusaurus: Diataxis quadrants, structure and voice rules, and four references for patterns, writing, config, and deployment. Content preserved from the source; renames the skill, strengthens the description for triggering, and converts the reference list into a routing table stating when to load each file. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-30 22:58:08 +03:00
parent ed7c7f0d95
commit a596731f67
6 changed files with 1189 additions and 1 deletions
@@ -1 +1,53 @@
-# documentation-docusaurus
+# documentation-docusaurus
+
+Agent Skill for building documentation sites with **Docusaurus**, structured on the
+[Diátaxis](https://diataxis.fr/) framework — tutorials, how-to guides, reference, and
+explanation kept strictly apart.
+
+Opinionated by design. It takes positions on structure, voice, and configuration rather than
+listing options, and it asks who the reader is and what they should be able to *do* before
+writing anything.
+
+## Layout
+
+```text
+documentation-docusaurus/
+├── SKILL.md                          # Entry point — Diátaxis quadrants, structure, voice rules
+└── references/
+    ├── diataxis-patterns.md          # Template per quadrant, decision tree, cross-linking
+    ├── writing-guide.md              # Voice, words to cut, inclusive language, checklist
+    ├── config-reference.md           # docusaurus.config.ts — what matters, what to leave alone
+    └── deployment.md                 # Vercel, Netlify, GitHub Pages, Cloudflare, debugging
+```
+
+## The core idea
+
+| Type | Purpose | Question it answers |
+|---|---|---|
+| **Tutorial** | Learning | "Can you teach me to…?" |
+| **How-to** | Doing | "How do I…?" |
+| **Reference** | Information | "What is the API for…?" |
+| **Explanation** | Understanding | "Why does…?" |
+
+Don't mix them. A tutorial that turns into reference halfway through loses both audiences.
+
+The docs tree follows the reader's journey — learn, do, understand, look up:
+
+```text
+docs/
+├── getting-started/     # Tutorials
+├── guides/              # How-tos
+├── concepts/            # Explanation
+├── reference/           # Reference
+└── resources/           # Links, community, changelog
+```
+
+## Deploy
+
+```bash
+cd ../skill-manager/scripts
+task deploy -- --skill-dir="$(cd ../../documentation-docusaurus && pwd)"
+```
+
+Built with the `skill-manager` skill, following the
+[agentskills.io specification](https://agentskills.io/specification).