skill-doc-generatorlisted
Install: claude install-skill freitasp1/claude-code-skills
# Skill Documentation Generator
Auto-generate high-quality README documentation for skills with built-in consistency validation and example generation.
## Overview
This skill automates the creation of standardized README files for skills by analyzing SKILL.md files, extracting structure and examples, validating quality standards, and generating comprehensive documentation. It ensures consistency across skill documentation while providing actionable validation feedback.
## Workflow
### Single Skill Documentation
Generate documentation for one skill:
1. **Analyze the skill**:
```bash
python scripts/analyze_skill.py <skill_directory>
```
Extracts metadata, sections, code blocks, and resources.
2. **Validate consistency**:
```bash
python scripts/validate_consistency.py <skill_directory> --verbose
```
Checks frontmatter, description quality, and terminology.
3. **Generate README**:
```bash
python scripts/generate_readme.py <skill_directory> [output_path]
```
Creates README.md with validation results.
### Batch Documentation
Document multiple skills at once:
```bash
python scripts/document_directory.py <directory> [options]
```
**Options:**
- `--output <dir>`: Specify output directory
- `--no-recursive`: Don't search subdirectories
- `--no-index`: Skip index file generation
- `--no-validate`: Skip validation checks
**Example:**
```bash
# Document all user skills with validation
python scripts/document_directory.py /mnt/skills/user -