name	skill-generator
description	Generates complete Anthropic SKILL packages with proper structure, documentation, and automated download verification.

Skill Generator - Create Anthropic Skills with Download Verification

Trigger Words

"create a skill"
"make a skill"
"generate a skill"
"build a skill"
"new skill"
"skill generator"

Description

This skill generates complete Anthropic SKILL packages with proper structure, documentation, and automated download verification. It ensures all files are successfully transferred to the user's local machine.

Workflow

Phase 1: Requirements Gathering

Ask the user for skill specifications:
- Skill name: What should the skill be called?
- Description: What does the skill do?
- Trigger words: What words/phrases activate this skill?
- Functionality: What are the main features?
- Required files: Does it need Python scripts, bash scripts, config files?

Phase 2: Skill Creation

Create a directory structure: /tmp/skill-{skillname}/
Generate the following files:
- SKILL.md: Main skill documentation with:
  - Trigger words section
  - Description
  - Workflow/instructions
  - Usage examples
  - Technical details
- README.md: User-facing documentation
- Any additional files needed (Python scripts, bash scripts, configs, etc.)

Phase 3: File Verification (Pre-Download)

List all created files in /tmp/skill-{skillname}/
Display file count and names to user
Ask user to confirm files look correct before download

Phase 4: Download to User Machine

Copy all files from /tmp/skill-{skillname}/ to $OUTPUT_DIR/skill-{skillname}/
Maintain directory structure during copy
Display success message with file list

Phase 5: Post-Download Verification

Ask user to verify files are on their local machine:
- "Please check your downloads folder for the 'skill-{skillname}' directory"
- "Can you confirm you see the following files: [list files]"
Wait for user confirmation
If user confirms success:
- Provide installation instructions
- Explain how to use the skill
If user reports missing files:
- Troubleshoot the issue
- Offer to regenerate and re-download specific files

Phase 6: Installation Guidance

Provide clear instructions:

To install this skill:
1. Move the 'skill-{skillname}' folder to your skills directory
2. Ensure the folder structure is: skills/skill-{skillname}/SKILL.md
3. Test the skill by using one of these trigger phrases: {list triggers}

File Structure Template

Every skill should follow this structure:

skill-{skillname}/
├── SKILL.md           # Main skill documentation (REQUIRED)
├── README.md          # User-facing documentation (RECOMMENDED)
├── examples/          # Example files (OPTIONAL)
├── scripts/           # Python/Bash scripts (OPTIONAL)
└── configs/           # Configuration files (OPTIONAL)

SKILL.md Template

# {Skill Name} - {Brief Description}

## Trigger Words
- "trigger phrase 1"
- "trigger phrase 2"
- "trigger phrase 3"

## Description
{Detailed description of what the skill does}

## Workflow
1. Step 1
2. Step 2
3. Step 3

## Usage Examples
**Example 1:**
User: "{example user message}"
Assistant: {what the assistant should do}

## Technical Details
- {Any technical requirements}
- {Dependencies or prerequisites}
- {Special considerations}

## Files Included
- **SKILL.md**: This file
- **{other files}**: {description}

## Notes
{Any additional notes or warnings}

Implementation Notes

Creating Directory Structure

mkdir -p /tmp/skill-{skillname}/scripts
mkdir -p /tmp/skill-{skillname}/examples

Copying to Output

# Copy entire directory structure to OUTPUT_DIR
cp -r /tmp/skill-{skillname} $OUTPUT_DIR/

File Verification

# Before download - show what will be downloaded
echo "Files ready for download:"
find /tmp/skill-{skillname} -type f -exec basename {} \;

# Count files
find /tmp/skill-{skillname} -type f | wc -l

Best Practices

Always ask for requirements first - Don't assume what the user needs
Keep SKILL.md clear and concise - This is what the AI reads
Make README.md user-friendly - This is for humans
Include examples - Show how the skill should be used
Verify before download - Prevent unnecessary re-downloads
Confirm after download - Ensure files reached the user
Provide clear installation steps - Don't leave users guessing

Error Handling

If files don't download:

Check OUTPUT_DIR is accessible
Verify files exist in /tmp
Try copying individual files
Offer to create a zip archive as backup

If user can't find files:

Ask where they're checking
Explain typical download locations
Provide file names to search for
Offer to regenerate if needed

Example Interaction

User: "Create a skill for processing CSV files"

Assistant: "I'll help you create a CSV processing skill! Let me gather some details:

What should this skill be called? (e.g., 'csv-processor')
What specific CSV operations should it perform? (e.g., filtering, merging, transforming)
Should it include any Python scripts for data manipulation?
Any specific trigger phrases you'd like? (I'll suggest: 'process csv', 'csv tools', 'analyze csv')

Please provide these details so I can create the perfect skill for you!"

Security Considerations

Validate all user inputs for file names (no special characters that could break paths)
Keep all operations within allowed directories
Don't include sensitive information in skill files
Sanitize any code examples to prevent injection

Maintenance

When updating this skill:

Test the complete workflow end-to-end
Verify download mechanism works
Ensure verification steps are clear
Update examples if workflow changes

Install Skill

SKILL.md