Muse coding
def generate_skill(): const muse = new SkillAgent(); fn build() -> Result<Skill> func main() { muse.Run() } interface Skill { id: string } class Muse < SkillEngine def generate_skill(): const muse = new SkillAgent(); fn build() -> Result<Skill> func main() { muse.Run() } interface Skill { id: string } class Muse < SkillEngine
📖 Complete Guide

What is an AI Skill?

A skill is a folder that acts as your AI assistant's external brain — giving it expertise, rules, and tools tailored to your project.

🎯
Instant Expertise
⚡
Reusable & Portable
🔒
Consistent Quality
📂 Anatomy of a Skill

One Folder = AI's External Brain

Every skill is a self-contained folder with three core components. Drop it into your project's .agent/ directory and your AI assistant instantly gains new capabilities.

📄 SKILL.md Rules, identity, decision trees
📁 scripts/ Automation shell scripts
⚡ health-check.sh diagnostics
⚡ cost-report.sh cost tracking
📁 resources/ Reference materials & cheat sheets
🔗 references.md curated links
📝 cheat-sheet.md quick guide
🧠 How It Works

Progressive Disclosure — 3 Levels

Your AI assistant doesn't read the entire skill at once. It progressively loads only what it needs, saving context and improving response quality.

L1
YAML Frontmatter — Detection

The AI reads the YAML header (name, description, tags) to determine if this skill is relevant to the current task. Fast and lightweight.

L2
SKILL.md Body — Guidance

If relevant, the AI reads the full SKILL.md: identity, rules, decision trees, patterns, and guardrails. This shapes its behavior and expertise.

L3
Scripts & Resources — Execution

During task execution, the AI references scripts and resources as needed — running health checks, consulting cheat sheets, or following automation workflows.

🚀 Getting Started

Generate Your Skill Set in 3 Steps

SkillsMuse generates production-ready skill sets tailored to your project. Choose from 15 categories or paste a reference URL for analysis.

1

Choose or Paste

Select a project category (AI Agent, Web App, SaaS, etc.) or paste a reference website URL for AI-powered analysis.

2

Customize Options

Toggle features like dark mode, Muse persona, SEO, authentication, and more. Each option adds specific rules to your skill set.

3

Download & Install

Download the ZIP, extract to your project root, and your AI assistant instantly loads the new skills. Done!

💾 Installation

30-Second Installation

Two ways to install: ZIP Download from the website, or CLI one-liner from your terminal. Choose your platform below — or use npx skillsmuse install for the fastest setup.

# 1. Extract the downloaded ZIP file
unzip skill-agent.zip

# 2. Move .agent/ folder to your project root
mv .agent/ ~/your-project/

# 3. Type /muse in your AI chat — skills load automatically! ✨
# 1. Extract the downloaded ZIP file
unzip skill-agent.zip

# 2. Move CLAUDE.md to your project root
mv CLAUDE.md ~/your-project/

# 3. Move auxiliary files to project root
mv .skillsmuse/ ~/your-project/
# 1. Extract the downloaded ZIP file
unzip skill-agent.zip

# 2. Move .cursorrules to your project root
mv .cursorrules ~/your-project/

# 3. Move auxiliary files to project root
mv .skillsmuse/ ~/your-project/
# 1. Extract the downloaded ZIP file
unzip skill-agent.zip

# 2. Move .windsurfrules to your project root
mv .windsurfrules ~/your-project/

# 3. Move auxiliary files to project root
mv .skillsmuse/ ~/your-project/
# 1. Extract the downloaded ZIP file
unzip skill-agent.zip

# 2. Move .github/copilot-instructions.md to your project's .github/ folder
mkdir -p ~/your-project/.github/
mv .github/copilot-instructions.md ~/your-project/.github/

# 3. Move auxiliary files to project root
mv .skillsmuse/ ~/your-project/
⚡ Fastest method — one command installs directly to your project. No ZIP, no manual file moves.
# Install a skill from the catalog
npx skillsmuse install react-spa

# Install to a specific project folder
npx skillsmuse install react-spa ~/my-project

# Search for skills
npx skillsmuse search "Next.js"

# List popular skills
npx skillsmuse list

# That's it! Skills are ready to use ✨
📂 설치 위치 안내
• 기본: 현재 터미널 위치에 설치됩니다
• 다른 프로젝트에 설치하려면 경로를 뒤에 추가하세요
• 프로젝트 폴더가 없어도 자동 생성됩니다
~/Desktop/my-project/
└── .agent/skills/skill-name/
    ├── SKILL.md
    ├── resources/
    └── README.md
✨ Persona Skills

Regular Skills vs Persona Skills

Skills come in two types: Regular skills act as silent tools that activate automatically when needed. Persona skills add a character with personality, custom tone, and expressive interactions — they stay active throughout your entire session.

🔧

Regular Skill

Acts like a tool — auto-detected when relevant, deactivates when done. No personality, just expertise. Great for focused tasks like security scanning or database optimization.

💬 "Check security vulnerabilities" → Security skill auto-loads
✨

Persona Skill

Acts like a character — summoned via slash command, stays active all session. Has a name, personality, speaking style, and expressions. Perfect for guide companions.

💬 Type /muse → Muse persona activates with greeting

How to Invoke a Persona Skill

1
Check Available Commands

Look inside the .agent/workflows/ folder. Each .md file defines a slash command. For example, muse.md creates the /muse command.

2
Type the Slash Command

In your AI chat, type /muse (or any workflow command). The AI reads the persona's SKILL.md and activates the character with a greeting message.

3
Character Stays Active

Once summoned, the persona maintains its personality, tone, and expressions throughout the entire conversation. It combines domain expertise with a friendly character identity.

📁 .agent/
📁 skills/muse/ Persona identity + project rules
📄 SKILL.md Character, tone, expressions, expertise
📁 workflows/ Slash command definitions
⚡ muse.md /muse → activate persona
❓ FAQ

Frequently Asked Questions

SkillsMuse supports the 5 major AI coding assistants and platforms: Antigravity (.agent/SKILL.md), Cursor (.cursorrules), Windsurf (.windsurfrules), GitHub Copilot (.github/copilot-instructions.md), and Claude CLI (CLAUDE.md). Just select your Target Platform before downloading!
Absolutely! Generated skills are plain markdown files — fully editable. You can customize rules, add new scripts, modify guardrails, or extend the decision tree to match your exact workflow.
Yes. SkillsMuse generates skill files entirely in your browser. No data is sent to any server. Your project information never leaves your machine.
The ZIP contains the main instruction file for your chosen platform (e.g., .cursorrules, .windsurfrules, or .agent/SKILL.md), plus auxiliary folders containing scripts/ (automation helpers), resources/ (references & cheat sheets), and a README with installation instructions.
Yes! The core skill generator is free forever. We offer premium tiers for advanced features like unlimited generations, URL analysis engine, and pro skill packs. Check our Pricing page for details.
There's no hard limit. AI assistants like Antigravity use labels to tag each skill, then filter them like a funnel — only loading what's relevant to your current task. This means you can install 100, 500, even 1,000+ skills without performance issues. The more skills you have, the smarter your AI becomes at picking the right expertise.
It depends on the platform you chose:
- Antigravity: Move the entire `.agent/` folder to your project root.
- Cursor & Windsurf: Move the `.cursorrules` or `.windsurfrules` file directly to your project root.
- Claude: Move `CLAUDE.md` to your project root.
- Copilot: Move `copilot-instructions.md` into the `.github/` folder in your project root.
For the 4 non-Antigravity platforms, you will also see a `.skillsmuse/` folder containing auxiliary scripts and resources. You can optionally move this to your project root as well.
A Persona Skill adds a character identity to your AI assistant — complete with a name, personality, speaking style, and expressive reactions. To invoke it, type a slash command like /muse in your AI chat. Check your .agent/workflows/ folder to see available commands — each .md file creates a slash command (e.g., muse.md → /muse). Unlike regular skills that auto-activate silently, persona skills are summoned explicitly and maintain character consistency throughout your entire conversation.
The SkillsMuse CLI lets you install skills directly from your terminal with a single command: npx skillsmuse install <skill-name>. No need to download ZIPs or manually move files — it automatically creates the correct folder structure for your platform. You can also search (npx skillsmuse search "react") and browse (npx skillsmuse list) the Skill Hub from the command line. It auto-detects your platform (Antigravity, Cursor, or Claude) based on your project structure.
Both methods install the same skill content.
- ZIP Download: Visual experience — browse the website, preview skills, download a ZIP, and manually extract to your project. Best for discovery and first-time users.
- CLI Install: Developer experience — one terminal command, instant install. Best for speed, automation, and CI/CD pipelines. Use npx skillsmuse install <name> and it's done in seconds.

SkillsMuse is an AI skill factory — generating production-ready skill sets that transform your AI coding assistant into a domain expert. Built with the belief that every developer deserves an AI partner that truly understands their project.

Start Generating Skills →