agent-skill-creator/references/examples/exports/stock-analyzer-v1.0.0_INSTALL.md

# stock-analyzer - Installation Guide

**Version:** v1.0.0
**Generated:** 2025-10-24 12:56:28

---

## 📦 Export Packages

### Desktop/Web Package

**File:** `stock-analyzer-desktop-v1.0.0.zip`
**Size:** 0.01 MB
**Files:** 4 files included

✅ Optimized for Claude Desktop and claude.ai manual upload

### API Package

**File:** `stock-analyzer-api-v1.0.0.zip`
**Size:** 0.01 MB
**Files:** 4 files included

✅ Optimized for programmatic Claude API integration

---

## 🚀 Installation Instructions

### For Claude Desktop

1. **Locate the Desktop package**
   - File: `{skill}-desktop-{version}.zip`

2. **Open Claude Desktop**
   - Launch the Claude Desktop application

3. **Navigate to Skills settings**
   - Go to: **Settings → Capabilities → Skills**

4. **Upload the skill**
   - Click: **Upload skill**
   - Select the desktop package .zip file
   - Wait for upload confirmation

5. **Verify installation**
   - The skill should now appear in your Skills list
   - Try using it with a relevant query

✅ **Your skill is now available in Claude Desktop!**

---

### For claude.ai (Web Interface)

1. **Locate the Desktop package**
   - File: `{skill}-desktop-{version}.zip`
   - (Same package as Desktop - optimized for both)

2. **Visit claude.ai**
   - Open https://claude.ai in your browser
   - Log in to your account

3. **Open Settings**
   - Click your profile icon
   - Select **Settings**

4. **Navigate to Skills**
   - Click on the **Skills** section

5. **Upload the skill**
   - Click: **Upload skill**
   - Select the desktop package .zip file
   - Confirm the upload

6. **Start using**
   - Create a new conversation
   - The skill will activate automatically when relevant

✅ **Your skill is now available at claude.ai!**

---

### For Claude API (Programmatic Integration)

1. **Locate the API package**
   - File: `{skill}-api-{version}.zip`
   - Optimized for API use (smaller, execution-focused)

2. **Install required packages**
   ```bash
   pip install anthropic
   ```

3. **Upload skill programmatically**
   ```python
   import anthropic

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

   # Upload the skill
   with open('{skill}-api-{version}.zip', 'rb') as f:
       skill = client.skills.create(
           file=f,
           name="{skill}"
       )

   print(f"Skill uploaded! ID: {{skill.id}}")
   ```

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

   print(response.content)
   ```

5. **Important API requirements**
   - Must include beta headers: `code-execution-2025-08-25` and `skills-2025-10-02`
   - Maximum 8 skills per request
   - Skills run in isolated containers (no network access, no pip install)

✅ **Your skill is now integrated with the Claude API!**

---

## 📋 Platform Comparison

| Feature | Claude Code | Desktop/Web | Claude API |
|---------|-------------|-------------|------------|
| **Installation** | Plugin command | Manual upload | Programmatic |
| **Updates** | Git pull | Re-upload .zip | New upload |
| **Version Control** | ✅ Native | ⚠️ Manual | ✅ Versioned |
| **Team Sharing** | ✅ Via plugins | ❌ Individual | ✅ Via API |
| **marketplace.json** | ✅ Used | ❌ Ignored | ❌ Not used |

---

## ⚙️ Technical Details

### What's Included

**Desktop Package:**
- SKILL.md (core functionality)
- Complete scripts/ directory
- Full references/ documentation
- All assets/ and templates
- README.md and requirements.txt

**API Package:**
- SKILL.md (required)
- Essential scripts only
- Minimal documentation (execution-focused)
- Size-optimized (< 8MB)

### What's Excluded (Security)

For both packages:
- `.git/` (version control history)
- `__pycache__/` (compiled Python)
- `.env` files (environment variables)
- `credentials.json` (API keys/secrets)
- `.DS_Store` (system metadata)

For API package additionally:
- `.claude-plugin/` (Claude Code specific)
- Large documentation files
- Example files (size optimization)

---

## 🔧 Troubleshooting

### Upload fails with "File too large"

**Desktop/Web:**
- Maximum size varies by platform
- Try the API package instead (smaller)
- Contact support if needed

**API:**
- Maximum: 8MB
- The API package is already optimized
- May need to reduce documentation or scripts

### Skill doesn't activate

**Check:**
1. SKILL.md has valid frontmatter
2. `name:` field is present and ≤ 64 characters
3. `description:` field is present and ≤ 1024 characters
4. Description clearly explains when to use the skill

### API errors

**Common issues:**
- Missing beta headers (required!)
- Skill ID incorrect (check `skill.id` after upload)
- Network/pip install attempted (not allowed in API environment)

---

## 📚 Additional Resources

- **Export Guide:** See `references/export-guide.md` in the main repository
- **Cross-Platform Guide:** See `references/cross-platform-guide.md`
- **Main Documentation:** See the main README.md

---

## ✅ Verification Checklist

After installation, verify:

- [ ] Skill appears in Skills list
- [ ] Skill activates with relevant queries
- [ ] Scripts execute correctly
- [ ] Documentation is accessible
- [ ] No error messages on activation

---

**Need help?** Refer to the platform-specific documentation or the main repository guides.

**Generated by:** agent-skill-creator v3.2 cross-platform export system