HADS Claude Skill
Skill Verified ActiveUse when writing technical documentation that needs to be readable by both humans and AI models, converting existing docs to HADS format, validating a HADS document, or optimizing documentation for token-efficient AI consumption.
To provide a standardized format for technical documentation that is easily readable and processable by both humans and AI models.
Features
- Defines HADS: Human-AI Document Standard
- Specifies four distinct block types: [SPEC], [NOTE], [BUG], [?]
- Outlines required document structure including AI manifest
- Provides rules for AI reading and generation of HADS content
- Aims to optimize documentation for AI consumption and token efficiency
Use Cases
- Writing new technical documentation in HADS format
- Converting existing documentation to HADS
- Validating if a document adheres to HADS
- Optimizing large documents for AI token efficiency
Non-Goals
- Providing a fully automated HADS validator (planned)
- Interpreting or acting on non-HADS formatted documents
- Generating documentation in formats other than HADS
Workflow
- Read and understand the HADS specification
- Apply HADS formatting rules when writing or converting documentation
- Use the defined block types ([SPEC], [NOTE], [BUG], [?]) appropriately
- Ensure required document elements (title, version, AI manifest) are present
- Generate or validate HADS documents according to the skill's instructions
Practices
- Documentation structure
- AI readability
- Content standardization
Prerequisites
- Claude Code environment
Code Execution
- info:ValidationThe skill outlines validation rules for HADS documents but states that a formal validator is planned and not yet included, indicating incomplete validation implementation.
Installation
First, add the marketplace
/plugin marketplace add wshobson/agents/plugin install documentation-standards@claude-code-workflowsQuality Score
VerifiedTrust Signals
Similar Extensions
Readme I18n
100Use when the user wants to translate a repository README, make a repo multilingual, localize docs, add a language switcher, internationalize the README, or update localized README variants in a GitHub-style repository.
Teach Guidance
100Guide a person in becoming a better teacher and explainer. AI coaches content structuring, audience calibration, explanation clarity, Socratic questioning technique, feedback interpretation, and reflective practice for technical presentations, documentation, and mentoring. Use when a person needs to present technical content and wants preparation coaching, wants to write better documentation or tutorials, struggles to explain concepts across expertise levels, is mentoring a colleague, or is preparing for a talk or knowledge-sharing session.
Prepare Inspection Readiness
100Prepare an organisation for regulatory inspection by assessing readiness against agency-specific focus areas (FDA, EMA, MHRA). Covers warning letter and 483 theme analysis, mock inspection protocols, document bundle preparation, inspection logistics, and response template creation. Use when a regulatory inspection has been announced or is anticipated, when a periodic self-assessment is due, when new systems have been implemented since the last inspection, or after a significant audit finding that may attract regulatory attention.
External Context
100Invoke parallel document-specialist agents for external web searches and documentation lookup
Deepinit
100Deep codebase initialization with hierarchical AGENTS.md documentation
Next Cache Components
100Next.js 16 Cache Components - PPR, use cache directive, cacheLife, cacheTag, updateTag