ccgg-skills-factory

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# Skills Factory - CCGG Community Edition

**Created by**: [Daron Vener](https://github.com/DaronVee)
**Community**: [CCGG - Custom GPT Goldmine](https://www.skool.com/ccgg)
**Contributors**: Claude Code

Production-ready meta-skill for creating Claude Code skills with evaluation-driven development, progressive disclosure patterns, and comprehensive validation.

---

## Quick Start (Claude Code CLI)

**Step 1**: Download the latest [Release ZIP](https://github.com/DaronVee/ccgg-skills-factory/releases)

**Step 2**: Extract and install

```bash
cd ccgg-skills-factory
python skills-factory/scripts/package_skill.py skills-factory --install personal

# Verify
ls ~/.claude/skills/skills-factory/SKILL.md

# Start using - Open Claude Code and say:
# "Create a new skill for [your use case]"
```

**Prefer Git?** Clone instead: `git clone https://github.com/DaronVee/ccgg-skills-factory.git` then run install command

---

## Platform Compatibility

| Platform | Installation | Script Execution | Requirements |
|----------|-------------|------------------|--------------|
| **Claude Code (CLI)** | Download ZIP + install | ✅ Local environment | Python 3.x installed |
| **Claude Desktop** | Download ZIP + upload | ✅ Server-side sandbox | "Code execution" enabled in Settings > Capabilities |
| **Claude.ai (Web)** | Download ZIP + upload | ✅ Server-side sandbox | "Code execution" enabled in Settings > Capabilities |

**All platforms support full functionality!** Scripts execute in secure sandboxes (Desktop/Web) or your local environment (Claude Code).

---

## What's Included

### Core Skill
- **SKILL.md** (~19 KB): Main skill file with intelligent frontmatter configuration, progressive disclosure, evaluation-driven development framework, and comprehensive guidance

### Automation Scripts (4 Python files)
- **comprehensive_validate.py** (~700 lines): Deep validation with 15+ checks (YAML structure, new frontmatter fields, invocation control, code patterns, progressive disclosure, etc.)
- **init_skill.py** (~390 lines): Skill generator with template creation, commented optional fields, and structure scaffolding
- **package_skill.py** (235 lines): Packager/installer for personal, project, and distribution deployment
- **quick_validate.py** (65 lines): Fast validation for iterative development

### Reference Guides (8 comprehensive docs)
- **FRONTMATTER_DECISION_GUIDE.md**: 6-question intelligent configuration wizard for YAML frontmatter fields
- **SUBAGENT_PATTERNS.md**: Bidirectional skill/subagent integration patterns (context: fork + skills field)
- **DEPLOYMENT_GUIDE.md** (6,000+ words): Complete deployment workflows including nested discovery, --add-dir, and plugin namespacing
- **EVALUATION_GUIDE.md**: Evaluation-driven development methodology with fork evaluation scenarios
- **TROUBLESHOOTING.md**: 15 common issues with detailed solutions
- **TWO_CLAUDE_METHODOLOGY.md**: Iterative testing framework using two Claude instances
- **VALIDATION_PATTERNS.md**: Feedback loop patterns and quality gates
- **WORKFLOW_PATTERNS.md**: Design patterns for skill creation (simple, standard, complex, forked context)

---

## System Requirements

### Required
- **Python 3.x** (no external packages needed - pure standard library)
- **Claude Code v1.0+** (for CLI usage) OR Claude Desktop/Web with Pro/Max/Team/Enterprise plan
- **Code execution enabled**: Settings > Capabilities > "Code execution and file creation" (Desktop/Web only)

### Optional
- **Git** (for team sharing and version control)
- **Text editor** (for manual skill editing)

---

## Installation Options

### Option 1: Claude Code CLI (Recommended for Power Users)

**Download**: Get the latest [Release ZIP](https://github.com/DaronVee/ccgg-skills-factory/releases) or clone with Git

**Personal Installation** (skill available across all projects):
```bash
# Extract ZIP or clone, then:
cd ccgg-skills-factory
python skills-factory/scripts/package_skill.py skills-factory --install personal
```

**Project Installation** (skill shared with team via Git):
```bash
cd /path/to/your-project
python /path/to/ccgg-skills-factory/skills-factory/scripts/package_skill.py skills-factory --install project

# Commit to share with team
git add .claude/skills/skills-factory/
git commit -m "Add Skills Factory for team skill creation"
git push
```

### Option 2: Claude Desktop / Web (Easiest for Beginners)

**The ZIP in releases is already packaged!** Just download and upload directly:

1. Download `skills-factory.zip` from [Releases](https://github.com/DaronVee/ccgg-skills-factory/releases)
2. Upload to Claude:
   - **Desktop**: Settings > Features > Skills > Upload Skill
   - **Web**: Settings (gear icon) > Features > Skills > Upload Skill
3. Enable code execution:
   - Settings > Capabilities > Toggle ON "Code execution and file creation"
4. Verify:
   - Start new conversation
   - Ask: "What skills are available?"
   - Should see "skills-factory" in response

---

## Documentation

### For Beginners
- [Installation Guide](https://github.com/DaronVee/ccgg-skills-factory/blob/HEAD/docs/INSTALLATION_GUIDE.md) - Step-by-step with screenshots and troubleshooting
- [FAQ](https://github.com/DaronVee/ccgg-skills-factory/blob/HEAD/docs/FAQ.md) - Common questions and answers
- [Platform Compatibility](https://github.com/DaronVee/ccgg-skills-factory/blob/HEAD/docs/PLATFORM_COMPATIBILITY.md) - Detailed platform comparison

### For Advanced Users
- [Frontmatter Decision Guide](https://github.com/DaronVee/ccgg-skills-factory/blob/HEAD/skills-factory/references/FRONTMATTER_DECISION_GUIDE.md) - Intelligent YAML configuration wizard
- [Subagent Patterns](https://github.com/DaronVee/ccgg-skills-factory/blob/HEAD/skills-factory/references/SUBAGENT_PATTERNS.md) - Skill/subagent integration patterns
- [Deployment Guide](https://github.com/DaronVee/ccgg-skills-factory/blob/HEAD/skills-factory/references/DEPLOYMENT_GUIDE.md) - Complete deployment workflows
- [Evaluation Guide](https://github.com/DaronVee/ccgg-skills-factory/blob/HEAD/skills-factory/references/EVALUATION_GUIDE.md) - Evaluation-driven development
- [Troubleshooting](https://github.com/DaronVee/ccgg-skills-factory/blob/HEAD/skills-factory/references/TROUBLESHOOTING.md) - 15 common issues + solutions

---

## Features

### Progressive Disclosure
Skills reveal information gradually based on context:
- **Tier 1**: Core instructions (always visible)
- **Tier 2**: Detailed guidance (shown when relevant)
- **Tier 3**: Advanced patterns (shown for complex scenarios)

### Evaluation-Driven Development
Build skills iteratively with continuous validation:
1. Define success criteria upfront
2. Build minimal viable skill
3. Test with real scenarios
4. Refine based on feedback
5. Validate comprehensively

### Comprehensive Validation
Four validation levels ensure quality:
- **Quick Validate**: Fast syntax + structure checks
- **Comprehensive Validate**: Deep analysis (15+ checks including new frontmatter fields)
- **Two-Claude Testing**: Real-world usage testing
- **Production Readiness**: Final quality gates

### Intelligent Frontmatter Configuration
6-question decision guide that determines the right YAML configuration:
- **Invocation Control**: Who triggers the skill (user, Claude, or both)?
- **Execution Context**: Main conversation or isolated subagent (context: fork)?
- **Arguments**: Does the skill accept parameters ($ARGUMENTS, $0, $1)?
- **Tool Access**: Should tools be restricted (allowed-tools)?
- **Dynamic Data**: Does the skill need live shell data (!`command`)?
- **Hooks**: Pre/post execution validation needed?

### Subagent Integration
Two patterns for skill/subagent interaction:
- **Pattern A**: Skill spawns subagent (`context: fork`) - for context protection, parallel execution, tool restriction
- **Pattern B**: Subagent uses skills (`skills` field) - for domain-specific agents with preloaded knowledge

### Design Patterns
Pre-built architectures for common use cases:
- **Simple Skills**: Single-purpose, minimal complexity
- **Standard Skills**: Multi-section, moderate complexity
- **Complex Skills**: Advanced patterns with subagents, hooks, multi-file support
- **Forked Context**: Isolated execution for heavy research or parallel tasks

---

## Usage Examples

### Create Your First Skill

```
You: "Create a new skill for generating meeting notes from transcripts"

Claude (with Skills Factory):
1. Analyzes your use case
2. Suggests skill architecture (simple/standard/complex)
3. Generates SKILL.md with appropriate sections
4. Creates validation checklist
5. Guides you through testing

Result: Production-ready skill in 15-30 minutes
```

### Validate Existing Skill

```bash
# Quick validation (fast feedback)
python skills-factory/scripts/quick_validate.py /path/to/your-skill

# Comprehensive validation (production readiness)
python skills-factory/scripts/comprehensive_validate.py /path/to/your-skill
```

### Package for Distribution

```bash
# Create ZIP for sharing
python skills-factory/scripts/package_skill.py your-skill --package

# Install to personal skills
python skills-factory/scripts/package_skill.py your-skill --install personal

# Install to project (team sharing)
python skills-factory/scripts/package_skill.py your-skill --install project
```

---

## Contributing

This is a CCGG community resource. Contributions welcome!

### Ways to Contribute
- **Bug Reports**: Open an [Issue](https://github.com/DaronVee/ccgg-skills-factory/issues)
- **Documentation**: Improve guides, add examples
- **Feature Requests**: Suggest enhancements
- **Skill Examples**: Share skills you've created

### Support
- **GitHub Issues**: Technical questions, bugs, feature requests
- **CCGG Community**: https://www.skool.com/ccgg - General questions, best practices, showcases

---

## Version History

See [CHANGELOG.md](https://github.com/DaronVee/ccgg-skills-factory/blob/HEAD/CHANGELOG.md) for detailed version history.

**Current**: v2.0.0 - Full Feature Alignment (2026-02-09)

---

## License

MIT License - See [LICENSE](https://github.com/DaronVee/ccgg-skills-factory/tree/HEAD/LICENSE) for details.

---

## Acknowledgments

**Created by**: Daron Vener - [CCGG Community](https://www.skool.com/ccgg)
**Built with**: Claude Code - Anthropic's CLI for autonomous coding
**Methodology**: Evaluation-driven development + Progressive disclosure patterns

---

**Ready to create your first skill?** Download the [latest release](https://github.com/DaronVee/ccgg-skills-factory/releases) and follow the Quick Start above!

Skills Factory - CCGG Community Edition

Created by: Daron Vener Community: CCGG - Custom GPT Goldmine Contributors: Claude Code

Production-ready meta-skill for creating Claude Code skills with evaluation-driven development, progressive disclosure patterns, and comprehensive validation.

Quick Start (Claude Code CLI)

Step 1: Download the latest Release ZIP

Step 2: Extract and install

cd ccgg-skills-factory
python skills-factory/scripts/package_skill.py skills-factory --install personal

# Verify
ls ~/.claude/skills/skills-factory/SKILL.md

# Start using - Open Claude Code and say:
# "Create a new skill for [your use case]"

Prefer Git? Clone instead: git clone https://github.com/DaronVee/ccgg-skills-factory.git then run install command

Platform Compatibility

Platform	Installation	Script Execution	Requirements
Claude Code (CLI)	Download ZIP + install	✅ Local environment	Python 3.x installed
Claude Desktop	Download ZIP + upload	✅ Server-side sandbox	"Code execution" enabled in Settings > Capabilities
Claude.ai (Web)	Download ZIP + upload	✅ Server-side sandbox	"Code execution" enabled in Settings > Capabilities

All platforms support full functionality! Scripts execute in secure sandboxes (Desktop/Web) or your local environment (Claude Code).

What's Included

Core Skill

SKILL.md (~19 KB): Main skill file with intelligent frontmatter configuration, progressive disclosure, evaluation-driven development framework, and comprehensive guidance

Automation Scripts (4 Python files)

comprehensive_validate.py (~700 lines): Deep validation with 15+ checks (YAML structure, new frontmatter fields, invocation control, code patterns, progressive disclosure, etc.)
init_skill.py (~390 lines): Skill generator with template creation, commented optional fields, and structure scaffolding
package_skill.py (235 lines): Packager/installer for personal, project, and distribution deployment
quick_validate.py (65 lines): Fast validation for iterative development

Reference Guides (8 comprehensive docs)

FRONTMATTER_DECISION_GUIDE.md: 6-question intelligent configuration wizard for YAML frontmatter fields
SUBAGENT_PATTERNS.md: Bidirectional skill/subagent integration patterns (context: fork + skills field)
DEPLOYMENT_GUIDE.md (6,000+ words): Complete deployment workflows including nested discovery, --add-dir, and plugin namespacing
EVALUATION_GUIDE.md: Evaluation-driven development methodology with fork evaluation scenarios
TROUBLESHOOTING.md: 15 common issues with detailed solutions
TWO_CLAUDE_METHODOLOGY.md: Iterative testing framework using two Claude instances
VALIDATION_PATTERNS.md: Feedback loop patterns and quality gates
WORKFLOW_PATTERNS.md: Design patterns for skill creation (simple, standard, complex, forked context)

System Requirements

Required

Python 3.x (no external packages needed - pure standard library)
Claude Code v1.0+ (for CLI usage) OR Claude Desktop/Web with Pro/Max/Team/Enterprise plan
Code execution enabled: Settings > Capabilities > "Code execution and file creation" (Desktop/Web only)

Optional

Git (for team sharing and version control)
Text editor (for manual skill editing)

Installation Options

Option 1: Claude Code CLI (Recommended for Power Users)

Download: Get the latest Release ZIP or clone with Git

Personal Installation (skill available across all projects):

# Extract ZIP or clone, then:
cd ccgg-skills-factory
python skills-factory/scripts/package_skill.py skills-factory --install personal

Project Installation (skill shared with team via Git):

cd /path/to/your-project
python /path/to/ccgg-skills-factory/skills-factory/scripts/package_skill.py skills-factory --install project

# Commit to share with team
git add .claude/skills/skills-factory/
git commit -m "Add Skills Factory for team skill creation"
git push

Option 2: Claude Desktop / Web (Easiest for Beginners)

The ZIP in releases is already packaged! Just download and upload directly:

Download skills-factory.zip from Releases
Upload to Claude:
- Desktop: Settings > Features > Skills > Upload Skill
- Web: Settings (gear icon) > Features > Skills > Upload Skill
Enable code execution:
- Settings > Capabilities > Toggle ON "Code execution and file creation"
Verify:
- Start new conversation
- Ask: "What skills are available?"
- Should see "skills-factory" in response

Documentation

For Beginners

Installation Guide - Step-by-step with screenshots and troubleshooting
FAQ - Common questions and answers
Platform Compatibility - Detailed platform comparison

For Advanced Users

Frontmatter Decision Guide - Intelligent YAML configuration wizard
Subagent Patterns - Skill/subagent integration patterns
Deployment Guide - Complete deployment workflows
Evaluation Guide - Evaluation-driven development
Troubleshooting - 15 common issues + solutions

Features

Progressive Disclosure

Skills reveal information gradually based on context:

Tier 1: Core instructions (always visible)
Tier 2: Detailed guidance (shown when relevant)
Tier 3: Advanced patterns (shown for complex scenarios)

Evaluation-Driven Development

Build skills iteratively with continuous validation:

Define success criteria upfront
Build minimal viable skill
Test with real scenarios
Refine based on feedback
Validate comprehensively

Comprehensive Validation

Four validation levels ensure quality:

Quick Validate: Fast syntax + structure checks
Comprehensive Validate: Deep analysis (15+ checks including new frontmatter fields)
Two-Claude Testing: Real-world usage testing
Production Readiness: Final quality gates

Intelligent Frontmatter Configuration

6-question decision guide that determines the right YAML configuration:

Invocation Control: Who triggers the skill (user, Claude, or both)?
Execution Context: Main conversation or isolated subagent (context: fork)?
Arguments: Does the skill accept parameters ($ARGUMENTS, $0, $1)?
Tool Access: Should tools be restricted (allowed-tools)?
Dynamic Data: Does the skill need live shell data (!command)?
Hooks: Pre/post execution validation needed?

Subagent Integration

Two patterns for skill/subagent interaction:

Pattern A: Skill spawns subagent (context: fork) - for context protection, parallel execution, tool restriction
Pattern B: Subagent uses skills (skills field) - for domain-specific agents with preloaded knowledge

Design Patterns

Pre-built architectures for common use cases:

Simple Skills: Single-purpose, minimal complexity
Standard Skills: Multi-section, moderate complexity
Complex Skills: Advanced patterns with subagents, hooks, multi-file support
Forked Context: Isolated execution for heavy research or parallel tasks

Usage Examples

Create Your First Skill

You: "Create a new skill for generating meeting notes from transcripts"

Claude (with Skills Factory):
1. Analyzes your use case
2. Suggests skill architecture (simple/standard/complex)
3. Generates SKILL.md with appropriate sections
4. Creates validation checklist
5. Guides you through testing

Result: Production-ready skill in 15-30 minutes

Validate Existing Skill

# Quick validation (fast feedback)
python skills-factory/scripts/quick_validate.py /path/to/your-skill

# Comprehensive validation (production readiness)
python skills-factory/scripts/comprehensive_validate.py /path/to/your-skill

Package for Distribution

# Create ZIP for sharing
python skills-factory/scripts/package_skill.py your-skill --package

# Install to personal skills
python skills-factory/scripts/package_skill.py your-skill --install personal

# Install to project (team sharing)
python skills-factory/scripts/package_skill.py your-skill --install project

Contributing

This is a CCGG community resource. Contributions welcome!

Ways to Contribute

Bug Reports: Open an Issue
Documentation: Improve guides, add examples
Feature Requests: Suggest enhancements
Skill Examples: Share skills you've created

Support

GitHub Issues: Technical questions, bugs, feature requests
CCGG Community: https://www.skool.com/ccgg - General questions, best practices, showcases

Version History

See CHANGELOG.md for detailed version history.

Current: v2.0.0 - Full Feature Alignment (2026-02-09)

License

MIT License - See LICENSE for details.

Acknowledgments

Created by: Daron Vener - CCGG Community Built with: Claude Code - Anthropic's CLI for autonomous coding Methodology: Evaluation-driven development + Progressive disclosure patterns

Ready to create your first skill? Download the latest release and follow the Quick Start above!