skill-reviewer

To check if your Claude Code skill follows PDA best practices, use a structured review process that evaluates YAML frontmatter validity, naming conventions, and Progressive Disclosure Architecture compliance to surface concrete improvements before publishing.

Progressive Disclosure Architecture (PDA) for code documentation is a structural guideline that prevents monolithic SKILL.md files by suggesting progressive disclosure with references and on-demand content, ensuring documentation remains concise and token-efficient.

You validate YAML frontmatter in a SKILL.md file by running an automated structural evaluation that checks frontmatter validity, enforces naming conventions, and verifies descriptive clarity to ensure discoverability and safety for your Claude Code skill.

Yes, you can automate quality assurance reviews for skill documentation before publishing by applying a pre-publish validation workflow that checks organization, examples, dependencies, and security considerations to prepare skills for the marketplace.

Common quality issues found during a code review of skill files include invalid YAML frontmatter, monolithic documentation lacking progressive disclosure, unclear naming conventions, and token-inefficient content that fails PDA compliance guidelines.

Yes, a skill reviewer checks for security considerations in Claude Code skills by providing actionable recommendations covering organization, dependencies, and safety dimensions to ensure the skill is safe and ready for publishing.