skill-builder

Validate SKILL.md files against agentskills.io specification requirements.

Updated Oct 7, 2025

Search Tags:#documentation #validation #audit #compliance #skill #frontmatter

Ready to run

npx skills add https://github.com/TanaChu0409/book-keeper --skill skill-builder-tanachu0409

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-builder
Source: https://github.com/TanaChu0409/book-keeper/tree/main/.github/skills/skill-builder
Command: npx skills add https://github.com/TanaChu0409/book-keeper --skill skill-builder-tanachu0409

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Establish and enforce standards for Agent Skill definitions by validating SKILL.md frontmatter and structure against agentskills.io specifications.

Core Features & Use Cases

Automated frontmatter validation and structure checks
Enforcement of naming conventions and metadata requirements
Security checks to detect hard-coded secrets and unsafe content
Guidance for teams to create, review, and maintain compliant skills

Quick Start

Run the Skill Builder to audit all SKILL.md files in your repository and generate a compliance report.

Frequently Asked Questions about skill-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I validate SKILL.md frontmatter and structure for Agent Skills?▼

You can validate SKILL.md frontmatter by checking required fields like name and description, ensuring sections for trigger scenarios, operation steps, and examples exist, and enforcing naming consistency against the agentskills.io specification.

What is Agent Skill compliance auditing for repository documentation?▼

Agent Skill compliance auditing scans SKILL.md files under .github/skills and other directories to enforce metadata requirements, check structural sections, and detect hard-coded secrets or unsafe content, generating a compliance report.

How do I check Agent Skills for hard-coded secrets and unsafe content?▼

Security checks for Agent Skills scan SKILL.md files to detect hard-coded secrets and unsafe content, enforcing safety considerations while validating frontmatter, required sections, and naming consistency across the repository.

Does the Skill Builder work with SKILL.md files outside the .github/skills directory?▼

Yes, the Skill Builder validates Agent Skill units located under .github/skills and other Skill directories, applying frontmatter validation, naming consistency checks, and structure enforcement across all specified paths.

What sections are required in SKILL.md to pass Agent Skill validation?▼

SKILL.md validation requires a name and description in the frontmatter, plus dedicated sections for trigger scenarios, operation steps, checklists, and examples to meet the agentskills.io specification.

What are the limitations of automated Agent Skill compliance checking?▼

Automated compliance checking focuses on frontmatter validation, structural section enforcement, naming consistency, and secret detection, but may not fully assess semantic accuracy or complex contextual safety considerations within the skill content.