Skip to main content

Documentation Index

Fetch the complete documentation index at: https://colossal.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Agent Skills are structured guides that AI coding agents (Claude Code, Cursor, Codex, Gemini CLI, OpenCode, and ~50 others) load before acting. Each skill is a SKILL.md file with optional scripts and references that follows the Agent Skills specification. Colossal maintains a number of Agent Skills that your AI agent can use to create beautiful storefronts based on our design reference library — built to work seamlessly with the Colossal backend. The colossalhq/agent-skills repo bundles skills that cover the storefront workflow: SDK usage, design references, and design extraction.

​
Skills

SkillPurpose
Store BuilderUse the Storefront SDK in any React app — hooks, providers, types, and helpers.
Design LibraryCurated catalog of design references (design.json + theme.css + preview.html) ready to drop into a storefront.
Store DesignerCreate new design references from store screenshots, or apply an existing reference to any project (shadcn, Tailwind, vanilla CSS, Vue, Svelte).
Store Designer writes new references into the Design Library and reads from it when applying an existing design.

​
Install

Install all skills into the current project: 
npx skills add colossalhq/agent-skills --all
Pick specific skills and target agents: 
npx skills add colossalhq/agent-skills \
  --skill colossal-builder \
  --skill colossal-design-library \
  -a claude-code -a cursor \
  -y
Install globally across every project on your machine: 
npx skills add colossalhq/agent-skills -g
List skills without installing: 
npx skills add colossalhq/agent-skills --list
After install, skills land at <project>/.claude/skills/<name>/ for Claude Code and <project>/.agents/skills/<name>/ for most other agents. The CLI auto-detects which agents are present.

​
Update

npx skills update                      # refresh all installed skills
npx skills update colossal-design-library  # refresh one
Skills install via symlink by default, so updates are picked up immediately. With --copy, update replaces the bytes in place.

​
How agents use them

When the user describes a task that matches a skill’s description — “build a storefront”, “list available themes”, “extract a design from this screenshot” — the agent loads the skill and follows it. Skills include scripts the agent can run directly (theme analysis, listing references), example outputs, and the constraints that apply to every Colossal storefront. For the broader open-source skills library that powers Colossal’s built-in agents, see Skills.