skill-forge

Create and refine Claude Code and Codex skill packages with validation and iteration workflows.

5|Updated Jun 24, 2026
One-click install
npx skills add https://github.com/amadeus-dlc/amadeus --skill skill-forge-amadeus-dlc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-forge
Source: https://github.com/amadeus-dlc/amadeus/tree/main/.agents/skills/skill-forge
Command: npx skills add https://github.com/amadeus-dlc/amadeus --skill skill-forge-amadeus-dlc

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Skill Forge helps you create, refine, validate, and package Claude Code and Codex skills without guessing at the right structure, trigger boundary, or testing workflow.

Core Features & Use Cases

  • Skill authoring: Draft or revise SKILL.md files with clear boundaries, durable instructions, and platform-aware frontmatter.
  • Trigger tuning: Improve skill descriptions so they trigger on the right requests and avoid nearby false positives.
  • Evaluation workflow: Run evals, compare against baselines, grade outputs, aggregate benchmarks, and review results in a viewer.
  • Codex metadata: Generate and validate agents/openai.yaml for Codex-compatible skills.
  • Packaging and maintenance: Validate, package, and keep skill documentation and helper resources organized.
  • Use case: You have a rough skill draft and want to turn it into a reliable, testable skill with eval prompts, validation, and iteration guidance.

Quick Start

Ask Skill Forge to help you create, improve, test, or package a skill, and share the skill draft or the workflow you want converted into reusable instructions.

Frequently Asked Questions about skill-forge

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

FAQPage Schema
How do I structure a Claude Code skill package with the correct frontmatter and trigger boundaries?

To structure a Claude Code skill package, you need to create a SKILL.md file with platform-aware frontmatter and define clear trigger boundaries. Skill Forge drafts these files, refactors existing skills, and generates Codex-compatible agents/openai.yaml metadata to ensure proper validation and packaging.

What is the best way to test and benchmark AI skill triggers to avoid false positives?

Testing AI skill triggers to avoid false positives involves running evaluation workflows and comparing results against baselines. Skill Forge automates trigger eval design, grades outputs, aggregates benchmarks, and provides a viewer to review results and tune descriptions for accurate activation.

Can I use Skill Forge to generate and validate agents/openai.yaml for Codex skills?

Yes, you can use Skill Forge to generate and validate Codex metadata. It creates and validates the agents/openai.yaml file required for Codex-compatible skills, ensuring that your skill packaging aligns with platform-specific metadata layouts and passes validation checks.

How do I package Claude Code and Codex skills with validation and helper resources?

Packaging Claude Code and Codex skills requires validating SKILL.md files, organizing references, and keeping helper assets consistent. Skill Forge provides validation helpers and packaging workflows that check frontmatter parsing, verify trigger descriptions, and bundle skill files into a deployable format.

Does Skill Forge require pyyaml to parse frontmatter and run skill validation workflows?

Yes, Skill Forge requires the pyyaml dependency to parse frontmatter and execute its validation workflows. This library allows the skill to read YAML metadata from draft files, validate trigger boundaries, and aggregate benchmark reports during the eval iteration process.

Why does my AI skill trigger on unrelated requests and how can I refine the description?

AI skills trigger on unrelated requests when description boundaries are too broad or poorly defined. Skill Forge refines trigger descriptions by running automated evals against baseline prompts, grading the activation accuracy, and tuning the wording to eliminate nearby false positives.