bg-szy/TOP-SKILLS / skills/agent-skills/documentation-quality
documentation-quality
VerifiedDocumentation quality standards and writing principles. Use when establishing formatting rules, reviewing doc quality metrics, creating writing guidelines, or enforcing consistent documentation style across a project.
| File | Kind | Size |
|---|---|---|
| CHANGELOG.md | markdown | 6.3 KB |
| LICENSE.txt | markdown | 1.1 KB |
| SKILL.md | skill md | 5.3 KB |
CHANGELOG.md
View on GitHub# Changelog
## [2026-09-08] - Catalog Freshness And Source Sync
### Added
- Refreshed the catalog metadata and retained-client portability baseline.
### Changed
- Updated the catalog metadata and last-updated state for the 2026-09-08 maintenance pass.
- Kept the retained-client portability, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
### Fixed
- Preserved explicit no-MCP fallbacks and the catalog's safety, approval, and source-boundary guidance.
## [2026-09-05] - Catalog Freshness And Source Sync
### Added
- Refreshed the catalog metadata and retained-client portability baseline.
### Changed
- Updated the catalog metadata and last-updated state for the 2026-09-05 maintenance pass.
- Kept the retained-client portability, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
### Fixed
- Preserved explicit no-MCP fallbacks and the catalog's safety, approval, and source-boundary guidance.
## [2026-08-31] - Catalog Freshness And Source Sync
### Added
- Refreshed the catalog metadata and retained-client portability baseline.
### Changed
- Updated the catalog metadata and last-updated state for the 2026-08-31 maintenance pass.
- Kept the retained-client portability, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
### Fixed
- Preserved explicit no-MCP fallbacks and the catalog's safety, approval, and source-boundary guidance.
## [2026-08-29] - Catalog Freshness And Source Sync
### Added
- Refreshed the catalog metadata and retained-client portability baseline.
### Changed
- Updated the catalog metadata and last-updated state for the 2026-08-29 maintenance pass.
- Kept the retained-client portability, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
### Fixed
- Preserved explicit no-MCP fallbacks and the catalog's safety, approval, and source-boundary guidance.
## [2026-08-24] - Catalog Freshness And Source Sync
### Added
- Refreshed the catalog metadata and retained-client portability baseline.
### Changed
- Updated the catalog metadata and last-updated state for the 2026-08-24 maintenance pass.
- Kept the retained-client portability, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
### Fixed
- Preserved explicit no-MCP fallbacks and the catalog's safety, approval, and source-boundary guidance.
## [2026-08-14] - Catalog Freshness And Source Sync
### Added
- Refreshed the catalog metadata and retained-client portability baseline.
### Changed
- Updated the catalog metadata and last-updated state for the 2026-08-14 maintenance pass.
- Kept the retained-client portability, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
### Fixed
- Preserved explicit no-MCP fallbacks and the catalog's safety, approval, and source-boundary guidance.
## [2026-07-29] - Version 2.0 Client Support Reset
### Added
- Added the current GitHub Copilot, Claude Code, and Codex portability baseline.
### Changed
- **BREAKING:** Removed Gemini CLI and Antigravity as supported clients.
- Refreshed catalog metadata and last-updated state for the 2026-07-29 maintenance pass.
- Kept the retained-client portability, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
### Fixed
- Prevented catalog modernization from reintroducing removed Gemini or Antigravity guidance.
## [2026-07-11] - Catalog Maintenance Refresh
### Added
- Added the current catalog verification baseline where it was missing.
### Changed
- Refreshed catalog metadata and last-updated state for the 2026-07-11 maintenance pass.
- Kept the cross-client, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
- Reclassified historical `Tested` or `Verified` changelog headings under the allowed changelog vocabulary without dropping their evidence.
### Fixed
- Closed validator and documentation drift so the enforced schema matches the documented skill baseline.
## [2026-04-25] - Version 1.2 Verification Protocol Refresh
### Added
- Added a `Verification Protocol` section with skill-specific pass/fail checks, one pressure-test scenario, and a measurable success metric.
- Added guidance to leverage native parallel subagent dispatch and 200k+ context windows where available.
- Added or referenced the shared documentation-stack approach to reduce duplicated documentation guidance.
### Changed
- Updated `SKILL.md` frontmatter to `version: "1.2"` and `last_updated: 2026-04-25`.
- Reframed activation guidance toward symptom -> action triggers and standardized two-stage review wording where applicable.
## [2026-04-24] - Version 1.1 Refresh
### Changed
- Updated the SKILL frontmatter version to `1.1` for the 2026-04-24 catalog refresh.
All notable changes to this skill will be documented in this file.
## [2026-04-24] - Skill Refresh
### Changed
- Standardized the SKILL frontmatter with version metadata, last-updated date, tags, and a concise catalog description.
- Reformatted the portability and MCP guidance with a preferred server line, a copy-paste fallback prompt, and consistent bullet lists.
- Added a catalog-standard Anti-Patterns section and refreshed the Related Skills links at the end of the skill.
- Added stronger cross-references to documentation-authoring and documentation-patterns, plus a ready-to-copy agent prompt template.
## [2026-04-04] - Cross-Client Portability Refresh
### Changed
- Added a standard portability note covering GitHub Copilot, Claude Code, Codex, and Gemini CLI.
- Clarified that the core workflow does not require a dedicated MCP server and can run with local tools alone.
### Changed
- Validated `SKILL.md` frontmatter, portability sections, and Gemini export readiness with `python scripts/validate-skills.py`.
## [2026-03-09] - Workspace Modernization
### Changed
- Reworked the skill around explicit documentation-quality standards and review criteria
### Added
- `scripts/doc-style-audit.py` for lightweight Markdown quality checks
## [2026-02-28] — Description Rewrite & Cross-References
### Changed
- Rewrote skill description to ~200 characters with clear, specific activation keywords
- Improved keyword specificity to reduce overlap with related skills
### Added
- `## Related Skills` cross-reference table with 2-4 related skills and "Use When" guidance
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file). | Stars: 198k | Updated | Claude CodeCodex | Unverified | Install |
| doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |