# Example for Claude Code
mkdir -p .claude/skills
cd .claude/skills
curl -O https://raw.githubusercontent.com/VoltAgent/awesome-agent-skills/main/skills/stripe/stripe-best-practices.md

# Clone the entire repository
git clone https://github.com/VoltAgent/awesome-agent-skills.git

# Copy specific skills to your agent's directory
cp awesome-agent-skills/skills/voltagent/create-voltagent.md .claude/skills/

# Document creation and editing
.claude/skills/docx.md          # Word documents
.claude/skills/pptx.md          # PowerPoint presentations
.claude/skills/xlsx.md          # Excel spreadsheets
.claude/skills/pdf.md           # PDF manipulation

# Design and development
.claude/skills/canvas-design.md        # Visual design
.claude/skills/frontend-design.md      # UI/UX development
.claude/skills/web-artifacts-builder.md # React + Tailwind artifacts
.claude/skills/algorithmic-art.md      # p5.js generative art

# Development tools
.claude/skills/mcp-builder.md         # MCP server creation
.claude/skills/webapp-testing.md      # Playwright testing
.claude/skills/skill-creator.md       # Create new skills

// Skills available:
// - create-voltagent: Project setup
// - voltagent-best-practices: Architecture patterns
// - voltagent-core-reference: API reference
// - voltagent-docs-bundle: Embedded documentation

// Example usage after installing skills
import { VoltAgent } from '@voltagent/core';

const agent = new VoltAgent({
  name: 'my-agent',
  model: 'claude-3-5-sonnet-20241022',
  apiKey: process.env.ANTHROPIC_API_KEY,
});

// Skills: angular-developer, angular-new-app

// Generate component with installed skills
// ng generate component my-component --standalone

// Skills: react-native-best-practices, upgrading-react-native

// Performance optimization patterns from Callstack skill
import { memo, useCallback } from 'react';

const OptimizedComponent = memo(({ data }) => {
  const handlePress = useCallback(() => {
    // Handle press
  }, []);
  
  return <TouchableOpacity onPress={handlePress}>...</TouchableOpacity>;
});

// Skills: best-practices, create-auth, emailAndPassword, twoFactor, organization

import { betterAuth } from 'better-auth';

const auth = betterAuth({
  database: {
    provider: 'pg',
    url: process.env.DATABASE_URL,
  },
  emailAndPassword: {
    enabled: true,
  },
  twoFactor: {
    enabled: true,
  },
});

// Skills: postgres-best-practices

import { createClient } from '@supabase/supabase-js';

const supabase = createClient(
  process.env.SUPABASE_URL,
  process.env.SUPABASE_ANON_KEY
);

// Use PostgreSQL best practices from skill
const { data, error } = await supabase
  .from('users')
  .select('*')
  .eq('active', true);

// Skills: stripe-best-practices, upgrade-stripe

import Stripe from 'stripe';

const stripe = new Stripe(process.env.STRIPE_SECRET_KEY, {
  apiVersion: '2024-11-20.acacia',
});

// Create payment intent following best practices
const paymentIntent = await stripe.paymentIntents.create({
  amount: 2000,
  currency: 'usd',
  automatic_payment_methods: { enabled: true },
});

// Skills: composio (1000+ app integrations)

import { Composio } from 'composio-core';

const composio = new Composio(process.env.COMPOSIO_API_KEY);

// Connect to external apps with managed auth
const connection = await composio.getConnection('github');

// Skills: courier-skills (multi-channel notifications)

import { CourierClient } from '@trycourier/courier';

const courier = new CourierClient({
  authorizationToken: process.env.COURIER_AUTH_TOKEN,
});

await courier.send({
  message: {
    to: { email: 'user@example.com' },
    content: { title: 'Welcome!', body: 'Thanks for signing up' },
    routing: { method: 'all', channels: ['email', 'sms'] },
  },
});

-- Skills: tinybird-best-practices, tinybird-cli-guidelines, 
--         tinybird-python-sdk-guidelines, tinybird-typescript-sdk-guidelines

-- Create a datasource (from skill patterns)
DESCRIPTION >
    User events datasource

SCHEMA >
    `timestamp` DateTime,
    `user_id` String,
    `event_type` String,
    `properties` String

ENGINE "MergeTree"
ENGINE_PARTITION_KEY "toYYYYMM(timestamp)"
ENGINE_SORTING_KEY "timestamp, user_id"

-- Skills: clickhouse

-- Optimized table creation from skill
CREATE TABLE events (
    timestamp DateTime,
    user_id UInt64,
    event_type String,
    properties String
)
ENGINE = MergeTree()
PARTITION BY toYYYYMM(timestamp)
ORDER BY (timestamp, user_id);

# Skills: gemini-api-dev, vertex-ai-api-dev, gemini-live-api-dev, gemini-interactions-api

import google.generativeai as genai

genai.configure(api_key=os.environ["GEMINI_API_KEY"])

model = genai.GenerativeModel('gemini-1.5-pro')
response = model.generate_content('Explain quantum computing')
print(response.text)

---
name: my-custom-skill
description: One-line description of what this skill does
triggers:
  - phrase users might say to invoke this skill
  - another trigger phrase
  - how do I use this tool
  - what are best practices for X
---

# My Custom Skill

## Overview

What this skill provides and when to use it.

## Installation

```bash
npm install my-package

// Working code example
import { MyTool } from 'my-package';

const tool = new MyTool({
  apiKey: process.env.MY_API_KEY,
});

// Real example
const result = await tool.doSomething();

// Real example with error handling
try {
  const result = await tool.complexOperation({
    param: 'value',
  });
} catch (error) {
  console.error('Operation failed:', error.message);
}

## Quality Standards

Skills in this collection follow these standards:

1. **Hand-picked**: Created by real engineering teams, not AI-generated
2. **Tested**: Used in production by actual developers
3. **Documented**: Clear examples and best practices
4. **Maintained**: Actively updated by project teams
5. **Practical**: Focus on real-world usage patterns

## Contributing

To contribute a skill:

1. Fork the repository
2. Create your skill following the template
3. Test it with at least one AI coding agent
4. Submit a pull request
5. Ensure your skill includes:
   - YAML frontmatter with name, description, triggers
   - Real code examples (no placeholders)
   - Environment variable references for secrets
   - Practical usage patterns

## Compatibility

Skills are plain Markdown files that work across all major AI coding agents:

- ✅ Claude Code (Anthropic)
- ✅ Codex
- ✅ Gemini CLI (Google)
- ✅ Cursor
- ✅ GitHub Copilot
- ✅ OpenCode
- ✅ Windsurf
- ✅ Antigravity

## Resources

- **Website**: [officialskills.sh](https://officialskills.sh/)
- **Repository**: [github.com/VoltAgent/awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills)
- **Discord**: Community support and discussions
- **Documentation**: Agent-specific setup guides

## License

MIT License - See repository for full license text.