gh-francyjglisboa-agent-skill-creator/exports/README.md

Exports Directory

This directory contains cross-platform export packages for skills created by agent-skill-creator.

📦 What's Here

This directory stores .zip packages optimized for different Claude platforms:

• Desktop packages (*-desktop-v*.zip) - For Claude Desktop and claude.ai manual upload
• API packages (*-api-v*.zip) - For programmatic Claude API integration
• Installation guides (*_INSTALL.md) - Platform-specific instructions for each export

🚀 Using Exported Packages

For Claude Desktop

1. Locate the -desktop- package for your skill
2. Open Claude Desktop → Settings → Capabilities → Skills
3. Click "Upload skill" and select the .zip file
4. Follow any additional instructions in the corresponding _INSTALL.md file

For claude.ai (Web)

1. Locate the -desktop- package (same as Desktop)
2. Visit https://claude.ai → Settings → Skills
3. Click "Upload skill" and select the .zip file
4. Confirm the upload

For Claude API

1. Locate the -api- package for your skill
2. Use the Claude API to upload programmatically:

import anthropic

client = anthropic.Anthropic(api_key="your-api-key")

with open('skill-name-api-v1.0.0.zip', 'rb') as f:
    skill = client.skills.create(
        file=f,
        name="skill-name"
    )

# Use in API requests
response = client.messages.create(
    model="claude-sonnet-4",
    messages=[{"role": "user", "content": "Your query"}],
    container={"type": "custom_skill", "skill_id": skill.id},
    betas=["code-execution-2025-08-25", "skills-2025-10-02"]
)

3. See the _INSTALL.md file for complete API integration instructions

📁 File Organization

Naming Convention

skill-name-{variant}-v{version}.zip
skill-name-{variant}-v{version}_INSTALL.md

Examples:

• financial-analysis-cskill-desktop-v1.0.0.zip
• financial-analysis-cskill-api-v1.0.0.zip
• financial-analysis-cskill-desktop-v1.0.0_INSTALL.md

Version Numbering

Versions follow semantic versioning (MAJOR.MINOR.PATCH):

• MAJOR: Breaking changes to skill behavior
• MINOR: New features, backward compatible
• PATCH: Bug fixes, optimizations

🔧 Generating Exports

Automatic (Opt-In)

After creating a skill, agent-skill-creator will prompt:

📦 Export Options:
   1. Desktop/Web (.zip for manual upload)
   2. API (.zip for programmatic use)
   3. Both (comprehensive package)
   4. Skip (Claude Code only)

Choose your option and exports will be generated here automatically.

On-Demand

Export any existing skill anytime:

"Export [skill-name] for Desktop"
"Export [skill-name] for API with version 2.1.0"
"Create cross-platform package for [skill-name]"

📊 Package Differences

Feature	Desktop Package	API Package
Size	Full (2-5 MB typical)	Optimized (< 8MB required)
Documentation	Complete	Minimal (execution-focused)
Examples	Included	Excluded (size optimization)
References	Full	Essential only
Scripts	All	Execution-critical only

🛡️ Security Notes

What's Excluded (for security):

• .env files (environment variables)
• credentials.json (API keys)
• .git/ directories (version control history)
• __pycache__/ (compiled Python)
• .DS_Store (macOS metadata)

What's Included:

• SKILL.md (required core functionality)
• scripts/ (execution code)
• references/ (documentation)
• assets/ (templates, prompts)
• requirements.txt (dependencies)
• README.md (usage instructions)

📚 Additional Resources

• Export Guide: ../references/export-guide.md
• Cross-Platform Guide: ../references/cross-platform-guide.md
• Main README: ../README.md

⚠️ Git Ignore

This directory is configured to ignore .zip files and _INSTALL.md files in git (they're generated artifacts). Only this README is tracked.

If you need to share exports, distribute them directly to users or host them externally.

---

Questions? See the export guide or cross-platform compatibility guide in the references/ directory.