fix: keep skill metadata within specification
This commit is contained in:
@@ -1,17 +1,12 @@
|
|||||||
---
|
---
|
||||||
name: documentation-docusaurus
|
name: documentation-docusaurus
|
||||||
description: >
|
description: >
|
||||||
Opinionated guidance for building and restructuring Docusaurus documentation sites on the
|
Opinionated Docusaurus v3 guidance using Diátaxis. Use when creating or restructuring documentation,
|
||||||
Diátaxis framework — separating tutorials, how-to guides, reference, and explanation, and
|
writing MDX, configuring navigation or deployment, building a local YAML data database, creating
|
||||||
refusing to mix them on one page. Use when creating a new docs site or page, reorganising an
|
React Flow roadmaps and dependency maps, or rendering editable Draw.io sources. Triggers on docs/,
|
||||||
existing one, deciding which quadrant a page belongs to, writing frontmatter, sidebars, or
|
blog/, docusaurus.config, sidebars, MDX, documentation data, and requests to write or improve docs.
|
||||||
admonitions, editing docusaurus.config.ts, applying voice and inclusive-language standards,
|
Requires the intended reader and outcome before writing, keeps documentation types separate, and
|
||||||
or setting up deployment to Vercel, Netlify, GitHub Pages, or Cloudflare Pages. Triggers on
|
applies accessibility, inclusive-language, build, browser, and deployment verification standards.
|
||||||
docs/, blog/, docusaurus.config, sidebars.ts, .mdx files, or any request to write, improve,
|
|
||||||
build a local YAML data database for React/MDX views, create React Flow roadmaps or dependency
|
|
||||||
maps, render editable Draw.io sources with docusaurus-plugin-drawio, or restructure documentation — even when the user only says "write docs", "document this",
|
|
||||||
or "the docs are a mess". Asks who the reader is and what they should be able to DO before
|
|
||||||
writing, because the answer decides the structure.
|
|
||||||
license: MIT
|
license: MIT
|
||||||
metadata:
|
metadata:
|
||||||
author: workspace-skills-code-agent
|
author: workspace-skills-code-agent
|
||||||
|
|||||||
Reference in New Issue
Block a user