skill-forge

Create and verify Topia skill units with frontmatter and eval-driven checks.

1|Updated May 18, 2026

Search Tags:#tdd #claude code #skill authoring #workflow validation #evals #topia

Ready to run

npx skills add https://github.com/linenoize/topia --skill skill-forge-linenoize

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-forge
Source: https://github.com/linenoize/topia/tree/main/skills/skill-forge
Command: npx skills add https://github.com/linenoize/topia --skill skill-forge-linenoize

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents weak or duplicate Topia skills from being shipped by forcing deliberate authoring, pressure testing, and quality verification before deployment.

Core Features & Use Cases

Skill creation and editing: Guides authors through building new skills or refining existing ones without breaking the nexus.
Quality and overlap checks: Catches duplicate coverage, missing sections, weak constraints, and other issues that commonly slip through in fast-moving agent workflows.
Behavioral validation: Uses pressure scenarios and evals to prove a skill works under real-world constraints before it is trusted.

Quick Start

Use skill-forge to review a Topia skill for overlap, pressure-test it, and confirm it is ready for deployment.

Frequently Asked Questions about skill-forge

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

FAQPage Schema

How do I validate a Topia skill before deployment?▼

You validate a Topia skill before deployment by applying test-before-write validation and pressure scenarios, generating structured reports that prove the skill works under real-world constraints for downstream tooling.

When do I need skill overlap analysis for workflow hubs?▼

Skill overlap analysis catches duplicate coverage in workflow hubs. You need it when building new Topia skills or editing existing files to prevent weak or duplicate skills from slipping through fast-moving agent workflows.

How do I create a Topia skill with compliant frontmatter?▼

To create a Topia skill with compliant frontmatter, you follow deliberate authoring guidance that enforces reference-backed rules, designs triggers, and wires the nexus to prevent breaking existing dependencies.

Does skill authoring with evals work with Claude Code?▼

Yes, eval-driven skill authoring works with Claude Code by applying test-driven development principles to pressure-test skill behavior, confirming constraints are met before the skill is trusted for deployment.

What is the best way to refine existing Topia skill files?▼

The best way to refine existing Topia skill files is through eval-driven refinement that checks for missing sections, weak constraints, and duplicate coverage without breaking the nexus wiring.

Why does my Topia skill fail behavioral validation?▼

Your Topia skill fails behavioral validation when pressure scenarios expose weak constraints or missing reference-backed guidance, proving the skill cannot handle real-world constraints before deployment.