mcaf-skill-curation

Audit and update SKILL.md frontmatter to align with AGENTS.md rules.

52|6|Updated Dec 1, 2025
One-click install
npx skills add https://github.com/managedcode/MCAF --skill mcaf-skill-curation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcaf-skill-curation
Source: https://github.com/managedcode/MCAF/tree/main/skills/mcaf-skill-curation
Command: npx skills add https://github.com/managedcode/MCAF --skill mcaf-skill-curation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps maintain and validate repository skills across Codex/Claude skill directories, ensuring SKILL.md frontmatter matches the actual codebase and AGENTS.md rules; it reduces drift, automates updates, and generates a metadata-only available_skills block for runtime.

Core Features & Use Cases

  • Audits all skill folders to verify that the YAML frontmatter name and description exist, are well-formed, and match the folder name.
  • Removes template cruft (README/INSTALL/CHANGELOG) from skill folders to keep the repository clean.
  • Updates triggers and generates an available_skills block to reflect current skills, enabling deterministic agent behavior.
  • Use Case: When a new skill is added or an existing one evolves, run this workflow to align it with AGENTS.md and the real codebase.

Quick Start

Run the curation workflow to inventory, validate, and align skills with AGENTS.md rules and the real codebase.

Frequently Asked Questions about mcaf-skill-curation

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

FAQPage Schema
How do I validate YAML frontmatter in SKILL.md files against my repository folders?

You can validate SKILL.md frontmatter by running an automated curation workflow that audits all skill folders, verifies the YAML name matches the folder name, and checks that the description exists and stays within length limits.

What is the best way to keep Codex and Claude skills aligned with AGENTS.md rules?

Keeping skills aligned with AGENTS.md rules involves running a curation workflow that inventories all skills, detects drift, removes outdated templates, and updates triggers to reflect the current real codebase.

How do I automatically remove outdated template files from skill directories?

You can automatically remove template cruft such as README, INSTALL, and CHANGELOG files from skill folders by executing the skill curation workflow to keep your repository clean.

Why does my skill folder name not match the YAML frontmatter name?

Folder name and YAML frontmatter name drift happens when skills evolve without metadata updates; the curation workflow detects this mismatch, reports it in a validation summary, and updates the YAML to match the folder.

How do I generate an available_skills block for deterministic agent behavior?

Generating an available_skills block requires running the curation workflow to inventory current skills, validate their metadata, and output a metadata-only block reflecting the real codebase for runtime agent use.