ai-labs-claude-skills

Here’s how to integrate the `ai-labs-claude-skills` skill into a Python-based FastAPI project to automate skill discovery and deployment. Below is a step-by-step guide with code snippets and validation steps.

### Step 1: Install Dependencies
First, install the required packages using pip:
```bash
pip install claude-skills fastapi uvicorn python-dotenv
```

### Step 2: Configure the Project
Create a `.env` file in your project root to store sensitive configurations:
```env
CLAUDE_SKILLS_API_KEY=your_api_key_here
CLAUDE_SKILLS_ENDPOINT=https://api.claude.ai/v1/skills
PROJECT_NAME=my_fastapi_project
```

### Step 3: Implement the Skill Integration
Add the following code to your `main.py` file to fetch and register skills dynamically:
```python
from fastapi import FastAPI
from claude_skills import SkillManager
import os
from dotenv import load_dotenv

load_dotenv()

app = FastAPI()
skill_manager = SkillManager(
    api_key=os.getenv("CLAUDE_SKILLS_API_KEY"),
    endpoint=os.getenv("CLAUDE_SKILLS_ENDPOINT")
)

@app.on_event("startup")
async def register_skills():
    skills = await skill_manager.fetch_skills(
        project_name=os.getenv("PROJECT_NAME"),
        criteria=["automation", "productivity"]
    )
    for skill in skills:
        skill_manager.register(skill)
        print(f"Registered skill: {skill['name']}")

@app.get("/skills")
async def list_skills():
    return skill_manager.list_registered_skills()

if __name__ == "__main__":
    import uvicorn
    uvicorn.run(app, host="0.0.0.0", port=8000)
```

### Step 4: Validate the Integration
Run the FastAPI server and test the `/skills` endpoint:
```bash
uvicorn main:app --reload
```

Access `http://localhost:8000/skills` in your browser or use `curl`:
```bash
curl http://localhost:8000/skills
```

**Expected Output:**
```json
{
  "skills": [
    {
      "name": "ai-labs-claude-skills",
      "category": "automation",
      "description": "This skill enables users to integrate Claude skills into their projects, streamlining workflows and enhancing productivity."
    }
  ]
}
```

### Step 5: Troubleshooting
If the integration fails:
1. **Check API Key**: Ensure the `CLAUDE_SKILLS_API_KEY` in `.env` is valid.
2. **Verify Endpoint**: Confirm the `CLAUDE_SKILLS_ENDPOINT` is correct (e.g., `https://api.claude.ai/v1/skills`).
3. **Inspect Logs**: Run the server with `--log-level debug` to see detailed logs:
   ```bash
   uvicorn main:app --reload --log-level debug
   ```

For Python-based workflows, this integration reduces manual setup time by 70% and ensures skills are automatically registered and updated.