skill-management

Create, audit, and validate agent skills against the Agent Skills open standard.

14|5|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/oakoss/agent-skills --skill skill-management-oakoss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-management
Source: https://github.com/oakoss/agent-skills/tree/main/skills/skill-management
Command: npx skills add https://github.com/oakoss/agent-skills --skill skill-management-oakoss

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the entire lifecycle of creating, auditing, and validating agent skills, ensuring adherence to open standards and high-quality discoverability.

Core Features & Use Cases

  • Skill Scaffolding: Guides the creation of new skills with correct directory structure and mandatory SKILL.md files.
  • Description Optimization: Provides rules for writing effective, discoverable descriptions that include trigger phrases and use cases.
  • Progressive Disclosure: Enforces a layered approach to information, keeping SKILL.md concise and detailed content in references.
  • Auditing & Validation: Implements a 9-phase audit process and validation scoring to ensure skills are accurate, complete, and up-to-date.
  • Use Case: When developing a new skill for a complex API, use this Skill to ensure its SKILL.md is well-structured, its description is discoverable, and its examples are accurate according to the latest documentation.

Quick Start

Use the skill-management skill to audit the 'tanstack-query' skill for compliance with the agent skills open standard.

Frequently Asked Questions about skill-management

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

FAQPage Schema
How do I audit agent skills for compliance with the open standard?

You audit agent skills by executing a 9-phase audit process that validates YAML frontmatter, verifies directory structure conventions, and detects manifest-implementation drift. This process classifies issue severity and provides validation scoring to ensure quality.

What is progressive disclosure in agent skill development?

Progressive disclosure in agent skill development is a layered information approach that keeps SKILL.md files concise while storing detailed content in references. This enforces best practices by maintaining clean skill boundaries and preventing context overload.

How do I write discoverable descriptions for agent skills?

You write discoverable descriptions for agent skills by following specific rules to include trigger phrases and explicit use cases. This ensures the description accurately represents processing logic and adheres to open standard metadata requirements.

Can I use skill-management to scaffold directory structure and SKILL.md files?

Yes, you can use skill-management to scaffold new skills by generating the correct directory structure and mandatory SKILL.md files. This ensures your skill authoring starts with a compliant foundation before validation.

What are the YAML frontmatter requirements for agent skills?

The YAML frontmatter requirements for agent skills mandate specific metadata fields that ensure discoverability and standard compliance. The skill-management skill validates these fields during the 9-phase audit to enforce open standard conventions.

Why does my agent skill validation fail with manifest-implementation drift?

Agent skill validation fails with manifest-implementation drift when declared metadata in the manifest does not match actual processing logic or components. The 9-phase audit process detects this drift and classifies it as a severity issue requiring correction.