my-skill

Validate frontmatter metadata extraction from SKILL.md files.

49|8|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/TokenRollAI/acplugin --skill my-skill-tokenrollai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: my-skill
Source: https://github.com/TokenRollAI/acplugin/tree/main/test-fixture/.claude/skills/my-skill
Command: npx skills add https://github.com/TokenRollAI/acplugin --skill my-skill-tokenrollai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate frontmatter metadata extraction for skills.

Core Features & Use Cases

  • Minimal sample to verify SKILL.md frontmatter parsing and metadata extraction.
  • Demonstrates how the instruction body is loaded as activation guidance.
  • Useful for validating the acplugin converter workflow in local and CI environments.

Quick Start

Run the acplugin converter on this skill to verify parsing and metadata extraction.

Frequently Asked Questions about my-skill

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

FAQPage Schema
How do I validate frontmatter metadata extraction for markdown skills?

To validate frontmatter metadata extraction, run the acplugin converter on a minimal skill file to verify that name and description fields parse correctly. This confirms the extraction workflow properly reads required metadata before loading the instruction body.

What fields are required in skill frontmatter for successful parsing?

Successful frontmatter parsing requires a name field and a description field in the metadata, plus a plain-text body for instructions. The converter checks for these elements to ensure the skill meets structural requirements during validation.

How does the acplugin converter load instructions from a skill file?

The acplugin converter loads instructions by parsing the SKILL.md frontmatter for metadata and then reading the plain-text body as activation guidance. This two-step process separates configuration from runtime instructions during the conversion workflow.

Can I use a minimal test skill to verify conversion in CI environments?

Yes, a minimal test skill can validate the acplugin converter workflow in both local and CI environments. Running the converter on a sample skill verifies parsing and metadata extraction without needing complex content or additional dependencies.

Why does my skill conversion fail when frontmatter is missing required fields?

Skill conversion fails when frontmatter lacks the required name or description fields because the parser cannot extract essential metadata. Ensure the frontmatter includes both fields and the body contains plain-text instructions to pass validation.