example-skill

This skill serves as a template and guide for creating new skills. It demonstrates the standard structure and best practices used by all skills in this codebase.

Overview

Every skill should provide:

• Core Documentation - Main concepts and quick start guide in SKILL.md
• API References - Detailed method/function documentation in resources/
• Code Examples - Working code samples in examples/
• Starter Templates - Ready-to-use setup files in templates/
• Troubleshooting - Common issues and solutions in docs/

Required Structure

skill-name/
├── SKILL.md                    # Main skill file (required)
├── resources/                  # API references and detailed docs
│   ├── api-reference.md
│   └── program-addresses.md
├── examples/                   # Working code examples
│   └── feature-name/
│       └── example.ts
├── templates/                  # Starter templates
│   └── setup.ts
└── docs/                       # Guides and troubleshooting
    └── troubleshooting.md

SKILL.md Format

Frontmatter (Required)

Every SKILL.md must start with YAML frontmatter:

---
name: skill-name
description: Brief description of what this skill covers. Should be 1-2 sentences explaining the protocol/tool and main features.
---

Recommended Sections

# Protocol Name Development Guide

Brief introduction paragraph.

## Overview

Bullet points of main features:
- **Feature 1** - Description
- **Feature 2** - Description

## Program IDs (for Solana protocols)

| Program | Address |
|---------|---------|
| Main Program | `address` |

## Quick Start

### Installation

\`\`\`bash
npm install package-name
\`\`\`

### Basic Setup

\`\`\`typescript
// Setup code example
\`\`\`

## Core Features

Document each major feature with:
- Explanation
- Code examples
- Important notes

## Best Practices

- Security considerations
- Performance tips
- Common patterns

## Resources

- Links to official docs
- GitHub repositories
- Community resources

## Skill Structure

Show the actual file structure of this skill.

Writing Guidelines

Code Examples

1. Always include imports - Show complete, runnable code
2. Use TypeScript - Prefer .ts files with proper types
3. Add comments - Explain non-obvious logic
4. Handle errors - Show proper error handling patterns
5. Use real addresses - Use actual program IDs, not placeholders

Documentation Style

1. Be concise - Get to the point quickly
2. Use tables - For lists of methods, addresses, parameters
3. Show, don't tell - Prefer code examples over lengthy explanations
4. Keep updated - Include version info and update dates

Resource Files

Create separate files in resources/ for:

• Complete API method references
• Program addresses and PDAs
• Configuration options
• Type definitions

Example Files

Examples in examples/ should be:

• Self-contained and runnable
• Well-commented
• Cover common use cases
• Include error handling

Template Files

Templates in templates/ should be:

• Ready to copy and use
• Include configuration options
• Have placeholder values clearly marked
• Include all necessary imports

Example Protocol Skill

Here's how a typical Solana protocol skill is structured:

---
name: protocol-name
description: Complete guide for Protocol Name - description of what it does.
---

# Protocol Name Development Guide

## Overview

Protocol Name provides:
- **Feature A** - What it does
- **Feature B** - What it does

## Program IDs

| Program | Address |
|---------|---------|
| Main | \`ProgramAddress111111111111111111111\` |

## Quick Start

### Installation

\`\`\`bash
npm install @protocol/sdk
\`\`\`

### Basic Setup

\`\`\`typescript
import { Protocol } from '@protocol/sdk';

const protocol = new Protocol(connection);
\`\`\`

## Core Operations

### Operation 1

\`\`\`typescript
// Code example
\`\`\`

### Operation 2

\`\`\`typescript
// Code example
\`\`\`

## Best Practices

- Practice 1
- Practice 2

## Resources

- [Official Docs](https://docs.protocol.com)
- [GitHub](https://github.com/protocol/sdk)

## Skill Structure

\`\`\`
protocol-name/
├── SKILL.md
├── resources/
│   ├── api-reference.md
│   └── program-addresses.md
├── examples/
│   └── basic/
│       └── example.ts
├── templates/
│   └── setup.ts
└── docs/
    └── troubleshooting.md
\`\`\`

Checklist for New Skills

• [ ] SKILL.md with proper frontmatter
• [ ] Overview section with feature list
• [ ] Program IDs table (for Solana protocols)
• [ ] Quick Start with installation and setup
• [ ] Core operations with code examples
• [ ] Best practices section
• [ ] Resources with external links
• [ ] Skill structure diagram
• [ ] resources/ with API references
• [ ] examples/ with working code
• [ ] templates/ with starter template
• [ ] docs/troubleshooting.md with common issues

Skill Structure

example-skill/
├── SKILL.md                    # This file
├── resources/
│   └── api-reference.md        # Example API reference format
├── examples/
│   └── basic/
│       └── example.ts          # Example code file
├── templates/
│   └── setup.ts                # Example template
└── docs/
    └── troubleshooting.md      # Example troubleshooting guide