Skills API
The Skills API provides access to Bootspring's library of battle-tested code patterns, implementation guides, and best practices.
Overview#
Skills are reusable code patterns organized by category:
- Built-in Skills: Included with Bootspring (auth, database, API patterns)
- External Skills: Premium skills from the external catalog (Pro tier)
Each skill includes:
- Detailed implementation guide
- Code examples
- Best practices
- Common pitfalls to avoid
REST API Endpoints#
List Skills#
Loading code block...
Returns available skills.
Query Parameters:
| Parameter | Type | Description |
|---|---|---|
includeExternal | boolean | Include external skill catalog |
category | string | Filter by category |
limit | number | Maximum results (default: 50) |
Response:
Loading code block...
Get Skill Details#
Loading code block...
Get full content of a skill.
Parameters:
| Parameter | Type | Description |
|---|---|---|
id | string | Skill identifier (e.g., auth/jwt) |
Query Parameters:
| Parameter | Type | Description |
|---|---|---|
summary | boolean | Return summary instead of full content |
sections | string | Comma-separated section keywords |
maxChars | number | Maximum content length |
Response:
Loading code block...
Search Skills#
Loading code block...
Search skills by query.
Request Body:
Loading code block...
Response:
Loading code block...
Apply Skill#
Loading code block...
Apply a skill pattern to your project.
Request Body:
Loading code block...
MCP Tool#
The bootspring_skill MCP tool provides skill functionality.
Tool Definition#
Loading code block...
Actions#
| Action | Description | Required Parameters |
|---|---|---|
list | List all skills | None |
show | Show skill content | name |
search | Search skills | query |
sync | Sync external catalog | manifestUrl |
Examples#
List skills:
Loading code block...
Show skill:
Loading code block...
Show specific sections:
Loading code block...
Search skills:
Loading code block...
Sync external catalog:
Loading code block...
Available Skill Categories#
auth#
Authentication and authorization patterns.
| Skill | Description |
|---|---|
auth/jwt | First-party JWT session auth |
auth/nextauth | NextAuth.js configuration |
auth/session | Session management with JWT |
auth/rbac | Role-based access control |
database#
Database patterns and ORM setup.
| Skill | Description |
|---|---|
database/prisma | Prisma ORM setup |
database/migrations | Database migration patterns |
database/seeding | Database seeding strategies |
api#
API design and implementation.
| Skill | Description |
|---|---|
api/route-handler | Next.js route handlers |
api/server-action | Server actions patterns |
api/validation | API input validation |
api/error-handling | API error handling |
payments#
Payment processing integrations.
| Skill | Description |
|---|---|
payments/stripe | Stripe integration |
payments/subscriptions | Subscription management |
payments/webhooks | Payment webhook handling |
testing#
Testing patterns and strategies.
| Skill | Description |
|---|---|
testing/vitest | Vitest setup and patterns |
testing/playwright | E2E testing with Playwright |
testing/mocking | Test mocking strategies |
External Skills (Pro Tier)#
External skills require a Pro subscription and include:
- Advanced caching strategies
- Multi-tenant architecture
- Enterprise authentication
- Advanced performance patterns
- Real-time features
Environment Variables#
| Variable | Description |
|---|---|
BOOTSPRING_SKILL_TOKEN | Bearer token for external catalog |
BOOTSPRING_SKILL_MANIFEST_URL | Remote manifest URL |
BOOTSPRING_SKILL_CONTENT_BASE_URL | Content base URL |
BOOTSPRING_SKILL_CACHE_DIR | Local cache directory |
BOOTSPRING_SKILL_MANIFEST_PUBLIC_KEY | PEM public key for signatures |
BOOTSPRING_SKILL_MANIFEST_REQUIRE_SIGNATURE | Require signature validation |
BOOTSPRING_SKILL_CATALOG_SOURCE | Source priority: auto, local, cache |
Error Handling#
Skill Not Found#
Loading code block...
External Skill Access Denied#
Loading code block...
Signature Verification Failed#
Loading code block...
CLI Commands#
Loading code block...
Best Practices#
- Start with built-in skills: They cover most common use cases
- Use search to discover: Find relevant patterns by keyword
- Request summaries first: Get overview before full content
- Combine skills: Use multiple skills for complex features
- Check for updates: Sync external catalog periodically
- Verify signatures: Enable signature verification in production