Agent-33: Skills Maker

Core Principle

Single agent, three input types, one output format. Convert any workflow description, SOP document, or existing agent into a Claude Desktop skill package ready for deployment.

When to Activate

Activate this agent when user:

• •Wants to create a new skill for Claude Desktop
• •Has an SOP that should become a skill
• •Wants to migrate an existing agent to skill format
• •Says "create a skill", "convert to skill", "migrate agent"
• •Asks about skill generation or deployment

Three Modes of Operation

Mode 1: Create from Scratch

Input: Description of what the skill should do Output: Complete skill package (.zip)

Usage:

./run_agent_33.py create \
  --name "skill-name" \
  --description "What it does" \
  --mcps "notion,gmail" \
  --examples "Example 1,Example 2"

Mode 2: Convert SOP to Skill

Input: Standard Operating Procedure document Output: Skill that automates the SOP workflow

Usage:

./run_agent_33.py sop \
  --input "path/to/sop.md" \
  --name "workflow-skill"

Mode 3: Migrate Agent to Skill

Input: Existing agent (Sub-Agent or simple agent) Output: Skill with same functionality

Usage:

./run_agent_33.py migrate \
  --agent 1 \
  --name "master-log-skill"

Output Structure

All modes generate the same structure:

output/skill-name/
├── SKILL.md           # Complete skill definition
├── README.md          # Installation instructions
├── examples/          # Optional examples
└── skill-name.zip     # Ready for Claude Desktop import

Quality Standards

All generated skills include:

• •✅ Proper frontmatter (name, description)
• •✅ Clear activation triggers
• •✅ MCP integration (if applicable)
• •✅ Success criteria checklist
• •✅ Examples and guidelines
• •✅ Professional README.md

MCP Integration

Agent-33 automatically detects and includes MCP dependencies:

Supported MCPs:

• •notion / notionApi
• •gmail / server-gmail-autoauth-mcp
• •playwright
• •filesystem
• •supabase
• •wordpress-mcp
• •elementor
• •firecrawl-mcp
• •fetch
• •context7
• •sequential-thinking
• •applescript-control-mac

Workflow Example

User: "Create a skill for Supabase query assistance"

Agent-33 executes:

1. •Parse request → detect need for supabase MCP
2. •Generate SKILL.md with:
   • •Activation keywords: "supabase", "query", "database"
   • •Guidelines for SQL best practices
   • •MCP integration section
   • •Success checklist
3. •Generate README.md with installation steps
4. •Package as .zip
5. •Output: output/supabase-query-helper/supabase-query-helper.zip

Result: Ready to import into Claude Desktop

Template Reference

Agent-33 uses proven skill patterns from:

• •curv-design-system
• •dashboard-auto-generation
• •formula-botanica-slides

All generated skills follow the same tested structure.

Success Checklist

When Agent-33 completes successfully:

• •✅ Skill directory created in output/
• •✅ SKILL.md has valid frontmatter
• •✅ README.md has installation instructions
• •✅ .zip package created and validated
• •✅ MCP dependencies detected and documented
• •✅ Activation keywords are specific and relevant

Deployment Steps

After generation:

1. •Locate .zip file in output/skill-name/
2. •Open Claude Desktop → Settings → Skills
3. •Click "Add Skill"
4. •Upload the .zip file
5. •Test activation with relevant keywords

Technical Details

Location: /Users/dannymcmillan/My Drive/Claude-Code-Projects/Sub-Agents/Agent-33-Skills-Maker/

Core Modules:

• •skill_generator.py - Core skill creation logic
• •package_builder.py - .zip packaging
• •sop_parser.py - Parse SOP documents
• •agent_parser.py - Parse existing agents

Validation:

• •Checks for required frontmatter
• •Validates SKILL.md structure
• •Ensures README.md exists
• •Verifies .zip package integrity

Common Use Cases

1. •SOP Automation: Convert written procedures into executable skills
2. •Agent Migration: Move 32 existing agents to Claude Desktop
3. •MCP Management: Create skills that orchestrate multiple MCPs
4. •Workflow Packaging: Bundle complex workflows as reusable skills

Error Handling

If skill generation fails:

• •Check input file exists (for SOP/migrate modes)
• •Ensure name is kebab-case (lowercase-with-hyphens)
• •Verify MCP names are valid
• •Review terminal output for specific errors

If .zip import fails in Claude Desktop:

• •"Zip file contains path with invalid characters" → macOS Icon files included (fixed in v1.1.0+)
  • •Solution: Delete Icon files from skill folder before packaging
  • •Or run: find skill-folder -name "Icon*" -delete
• •Validate frontmatter in SKILL.md
• •Ensure name and description are present
• •Check .zip contains SKILL.md and README.md
• •Verify no hidden files (.DS_Store, .git) in package

Next Steps

After using Agent-33:

1. •Review generated SKILL.md
2. •Test skill in Claude Desktop
3. •Refine activation keywords if needed
4. •Deploy to production

Version

• •Agent: Agent-33-Skills-Maker
• •Version: 1.1.0
• •Created: 2025-10-20
• •Updated: 2025-10-23 (Fixed macOS Icon\r file exclusion)
• •Compatibility: Claude Desktop skills format