skill-foundry

Generate and improve Claude Code SKILL.md files with progressive disclosure.

10|2|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/viktorbezdek/skillstack --skill skill-foundry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-foundry
Source: https://github.com/viktorbezdek/skillstack/tree/main/skill-foundry/skills/skill-foundry
Command: npx skills add https://github.com/viktorbezdek/skillstack --skill skill-foundry

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Provides a structured, philosophy-first framework and tooling to create, review, and improve Claude Code SKILL.md files so they activate reliably, avoid common anti-patterns, and scale across teams and projects.

Core Features & Use Cases

  • Philosophy-first guidance: establishes mental models before procedures to guide decision-making.
  • Progressive disclosure architecture: keep SKILL.md concise and push detailed material into references/.
  • Anti-pattern detection and prevention: lists common mistakes and how to avoid them.
  • Scripts and validation: includes initialization, quick validation, packaging, and analysis scripts to test activation and quality.
  • Use cases: create new skills from documentation, audit existing skills for activation and coverage, convert workflows into reusable skills, and debug activation failures.

Quick Start

Ask the skill to create a SKILL.md for a given capability using the 8-phase methodology with clear triggers, anti-patterns, references, and validation scripts.

Frequently Asked Questions about skill-foundry

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

FAQPage Schema
How do I create production-ready Claude Code skills from documentation?

Create production-ready Claude Code skills by applying an 8-phase methodology that generates SKILL.md files with concise frontmatter, explicit triggers, anti-pattern documentation, and progressive disclosure to ensure reliable activation.

What is progressive disclosure in skill authoring and why does it matter?

Progressive disclosure in skill authoring is an architecture that keeps SKILL.md files concise by pushing detailed reference material into a separate references directory. This matters because it maintains activation accuracy while scaling complex domain expertise across teams and projects without overwhelming the context window.

How do I prevent anti-patterns when authoring SKILL.md files?

Prevent anti-patterns when authoring SKILL.md files by using a philosophy-first framework that explicitly documents common mistakes and how to avoid them. This structured approach establishes mental models before procedures, guiding decision-making to prevent activation failures and ensure reliable skill execution.

How do I debug activation failures in existing Claude Code skills?

Debug activation failures in existing Claude Code skills by running validation and analysis scripts provided by the framework. These scripts test activation accuracy, audit coverage, and identify structural issues in your SKILL.md files to pinpoint why triggers are not matching user intents properly.

Can I convert manual workflows into reusable Claude Code skills?

Yes, you can convert manual workflows into reusable Claude Code skills by applying the skill authoring methodology to encode domain expertise into SKILL.md files. This process transforms workflows into validated skills with explicit triggers, anti-patterns, and optional validation scripts.

Do I need validation scripts to package and test Claude Code skills?

Validation scripts are optional but recommended for packaging and testing Claude Code skills. They allow you to initialize new skills, run quick quality validation checks, and analyze activation behavior to ensure your SKILL.md files meet the required standards for reliable execution.