skill-engineering

Guide creation, evaluation, and iteration of Claude Code skills with SKILL.md best practices.

19|Updated Jan 30, 2026

Search Tags:#skill development #documentation #prompt engineering #ai development #claude skills #skill iteration

Ready to run

npx skills add https://github.com/xobotyi/cc-foundry --skill skill-engineering

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-engineering
Source: https://github.com/xobotyi/cc-foundry/tree/main/plugins/ai-helpers/skills/skill-engineering
Command: npx skills add https://github.com/xobotyi/cc-foundry --skill skill-engineering

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured framework for creating, evaluating, and refining Claude Code skills, ensuring they are discoverable, functional, and robust.

Core Features & Use Cases

Skill Creation Guidance: Offers templates and best practices for writing SKILL.md files, including frontmatter, instructions, and reference structuring.
Description Optimization: Details how to write effective descriptions for reliable skill activation.
Use Case: When you need to build a new skill for Claude, or improve an existing one that isn't triggering correctly, this Skill guides you through the process from initial concept to final testing.

Quick Start

Use the skill-engineering skill to get a template for creating a new Claude skill.

Frequently Asked Questions about skill-engineering

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

FAQPage Schema

How do I write a Claude skill that activates reliably?▼

To write a Claude skill that activates reliably, optimize the description section in your SKILL.md file using best practices for instruction clarity and reference organization to ensure functional performance.

What is the best way to structure a SKILL.md file for AI development?▼

The best way to structure a SKILL.md file for AI development is to use a structured framework that includes clear frontmatter, well-organized instructions, and properly formatted references to ensure robust skill creation.

Why does my Claude skill fail to trigger or produce poor output quality?▼

Claude skills fail to trigger or produce poor output quality due to unclear descriptions and instructions, which can be resolved through structured debugging and refinement patterns.

How do I iterate on an existing Claude skill to improve its performance?▼

You iterate on an existing Claude skill by applying structured evaluation and refinement patterns to the instructions and references in your SKILL.md file, addressing activation failures and output quality issues.

Can I use this skill-engineering framework for debugging prompt engineering issues?▼

Yes, you can use this framework for debugging prompt engineering issues by applying structured debugging and refinement patterns to evaluate and improve instruction clarity and reference organization.