Project Skills
Project Skills are specialized folders of instructions, scripts, and resources that extend an AI agent's capabilities for specific, complex tasks.
Project Skills are specialized folders of instructions, scripts, and resources that extend an AI agent's capabilities for specific, complex tasks.
Location
Skills are located in .agents/skills/ directories (e.g., at the root .agents/skills or within specific workspaces like packages/backend/.agents/skills).
Structure of a Skill
Each skill folder contains:
SKILL.md(required): The main instruction file with YAML frontmatter (name, description) and detailed markdown instructions on how to perform the task.- Supporting Files (optional): Scripts, examples, and reference material that the AI can read to understand the task better.
Included Skills
The starter ships a curated, version-locked library of 50+ skills (pinned in
skills-lock.json) covering both building your SaaS and selling it.
Engineering
Skills that help agents navigate and extend the codebase:
- shadcn: Manages adding, styling, and debugging Shadcn UI components in
packages/ui. - turborepo: Provides guidance on monorepo structure, caching, and running package scripts.
- vercel-react-best-practices / vercel-composition-patterns: Keep new code aligned with modern React and Next.js performance and composition guidelines.
- web-design-guidelines: Reviews UI work against design-quality conventions.
- convex-*: Backend skills for setting up auth, planning migrations, auditing performance, and scaffolding components (also in
packages/backend/.agents/skills).
Growth & go-to-market
Skills that help you launch and grow the product you build on the starter, grouped by area:
- SEO & content:
ai-seo,seo-audit,programmatic-seo,schema,site-architecture,content-strategy,copywriting,copy-editing,free-tools,image,video. - Acquisition:
ads,ad-creative,aso,cold-email,prospecting,social,sms,co-marketing,community-marketing,public-relations,directory-submissions. - Conversion & lifecycle:
cro,ab-testing,signup,onboarding,paywalls,popups,pricing,offers,lead-magnets,emails,referrals,churn-prevention. - Strategy & ops:
marketing-plan,marketing-ideas,marketing-psychology,product-marketing,launch,analytics,customer-research,competitor-profiling,competitors,sales-enablement,revops.
Several growth skills look for an optional .agents/product-marketing.md
context file. Create it with your product's positioning, audience, and offer,
and the skills will tailor their output to what you're building. The file is
yours to write — the starter does not ship one.
How Agents Use Skills
When you ask an AI to perform a task (e.g., "Add a new Shadcn button component"), the agent is trained to look in the .agents/skills directories, read the relevant SKILL.md, and execute the task exactly as documented, utilizing any provided helper scripts.
Convex Agent Guidelines
When working with Convex, it's crucial that AI agents understand the specific API patterns and best practices, as these can sometimes differ from the generalized React or Node.js knowledge the AI was trained on.
Using Claude Code
Claude Code is an AI coding assistant from Anthropic that runs in your terminal and understands your codebase context.