From 2781ab8efa2e759899c28084e324c73b1e4e730d Mon Sep 17 00:00:00 2001 From: Mahmoud Date: Sat, 14 Mar 2026 02:12:36 +0200 Subject: [PATCH 01/75] Add frontend-design skill for distinctive production-grade UI generation Co-Authored-By: Claude Sonnet 4.6 --- README.md | 1 + frontend-design/SKILL.md | 42 ++++++++++++++++++++++++++++++++++++++++ 2 files changed, 43 insertions(+) create mode 100644 frontend-design/SKILL.md diff --git a/README.md b/README.md index 25a7af15..c8224526 100644 --- a/README.md +++ b/README.md @@ -110,6 +110,7 @@ Claude Skills are customizable workflows that teach Claude how to perform specif ### Development & Code Tools - [artifacts-builder](https://github.com/anthropics/skills/tree/main/skills/web-artifacts-builder) - Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). +- [frontend-design](./frontend-design/) - Create distinctive, production-grade frontend interfaces with high design quality. Generates creative, polished code that avoids generic AI aesthetics. - [aws-skills](https://github.com/zxkane/aws-skills) - AWS development with CDK best practices, cost optimization MCP servers, and serverless/event-driven architecture patterns. - [Changelog Generator](./changelog-generator/) - Automatically creates user-facing changelogs from git commits by analyzing history and transforming technical commits into customer-friendly release notes. - [Claude Code Terminal Title](https://github.com/bluzername/claude-code-terminal-title) - Gives each Claud-Code terminal window a dynamic title that describes the work being done so you don't lose track of what window is doing what. diff --git a/frontend-design/SKILL.md b/frontend-design/SKILL.md new file mode 100644 index 00000000..43aec9ae --- /dev/null +++ b/frontend-design/SKILL.md @@ -0,0 +1,42 @@ +--- +name: frontend-design +description: Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics. +license: Complete terms in LICENSE.txt +--- + +This skill guides creation of distinctive, production-grade frontend interfaces that avoid generic "AI slop" aesthetics. Implement real working code with exceptional attention to aesthetic details and creative choices. + +The user provides frontend requirements: a component, page, application, or interface to build. They may include context about the purpose, audience, or technical constraints. + +## Design Thinking + +Before coding, understand the context and commit to a BOLD aesthetic direction: +- **Purpose**: What problem does this interface solve? Who uses it? +- **Tone**: Pick an extreme: brutally minimal, maximalist chaos, retro-futuristic, organic/natural, luxury/refined, playful/toy-like, editorial/magazine, brutalist/raw, art deco/geometric, soft/pastel, industrial/utilitarian, etc. There are so many flavors to choose from. Use these for inspiration but design one that is true to the aesthetic direction. +- **Constraints**: Technical requirements (framework, performance, accessibility). +- **Differentiation**: What makes this UNFORGETTABLE? What's the one thing someone will remember? + +**CRITICAL**: Choose a clear conceptual direction and execute it with precision. Bold maximalism and refined minimalism both work - the key is intentionality, not intensity. + +Then implement working code (HTML/CSS/JS, React, Vue, etc.) that is: +- Production-grade and functional +- Visually striking and memorable +- Cohesive with a clear aesthetic point-of-view +- Meticulously refined in every detail + +## Frontend Aesthetics Guidelines + +Focus on: +- **Typography**: Choose fonts that are beautiful, unique, and interesting. Avoid generic fonts like Arial and Inter; opt instead for distinctive choices that elevate the frontend's aesthetics; unexpected, characterful font choices. Pair a distinctive display font with a refined body font. +- **Color & Theme**: Commit to a cohesive aesthetic. Use CSS variables for consistency. Dominant colors with sharp accents outperform timid, evenly-distributed palettes. +- **Motion**: Use animations for effects and micro-interactions. Prioritize CSS-only solutions for HTML. Use Motion library for React when available. Focus on high-impact moments: one well-orchestrated page load with staggered reveals (animation-delay) creates more delight than scattered micro-interactions. Use scroll-triggering and hover states that surprise. +- **Spatial Composition**: Unexpected layouts. Asymmetry. Overlap. Diagonal flow. Grid-breaking elements. Generous negative space OR controlled density. +- **Backgrounds & Visual Details**: Create atmosphere and depth rather than defaulting to solid colors. Add contextual effects and textures that match the overall aesthetic. Apply creative forms like gradient meshes, noise textures, geometric patterns, layered transparencies, dramatic shadows, decorative borders, custom cursors, and grain overlays. + +NEVER use generic AI-generated aesthetics like overused font families (Inter, Roboto, Arial, system fonts), cliched color schemes (particularly purple gradients on white backgrounds), predictable layouts and component patterns, and cookie-cutter design that lacks context-specific character. + +Interpret creatively and make unexpected choices that feel genuinely designed for the context. No design should be the same. Vary between light and dark themes, different fonts, different aesthetics. NEVER converge on common choices (Space Grotesk, for example) across generations. + +**IMPORTANT**: Match implementation complexity to the aesthetic vision. Maximalist designs need elaborate code with extensive animations and effects. Minimalist or refined designs need restraint, precision, and careful attention to spacing, typography, and subtle details. Elegance comes from executing the vision well. + +Remember: Claude is capable of extraordinary creative work. Don't hold back, show what can truly be created when thinking outside the box and committing fully to a distinctive vision. From 9635da5231da412d87f5f4b81cb0f2e2fa6ce802 Mon Sep 17 00:00:00 2001 From: Mahmoud Date: Mon, 16 Mar 2026 21:28:43 +0200 Subject: [PATCH 02/75] Add local Claude config and test email script Co-Authored-By: Claude Sonnet 4.6 --- .claude/settings.local.json | 41 +++++++++++++++++++++++++++++ .claude/worktrees/amazing-moser | 1 + .claude/worktrees/brave-golick | 1 + .claude/worktrees/competent-hopper | 1 + .claude/worktrees/elastic-edison | 1 + .claude/worktrees/focused-taussig | 1 + .claude/worktrees/keen-curie | 1 + .claude/worktrees/kind-dirac | 1 + .claude/worktrees/nice-dubinsky | 1 + .claude/worktrees/nice-merkle | 1 + .claude/worktrees/practical-mestorf | 1 + send_test_email.py | 20 ++++++++++++++ 12 files changed, 71 insertions(+) create mode 100644 .claude/settings.local.json create mode 160000 .claude/worktrees/amazing-moser create mode 160000 .claude/worktrees/brave-golick create mode 160000 .claude/worktrees/competent-hopper create mode 160000 .claude/worktrees/elastic-edison create mode 160000 .claude/worktrees/focused-taussig create mode 160000 .claude/worktrees/keen-curie create mode 160000 .claude/worktrees/kind-dirac create mode 160000 .claude/worktrees/nice-dubinsky create mode 160000 .claude/worktrees/nice-merkle create mode 160000 .claude/worktrees/practical-mestorf create mode 100644 send_test_email.py diff --git a/.claude/settings.local.json b/.claude/settings.local.json new file mode 100644 index 00000000..1c0a5621 --- /dev/null +++ b/.claude/settings.local.json @@ -0,0 +1,41 @@ +{ + "permissions": { + "allow": [ + "Skill(connect-apps:setup)", + "Bash(python3 -c \"\nfrom composio import Composio\ncomposio = Composio\\(api_key='ak_KuIQ5_IMvfiOlKpSQjLS'\\)\nsession = composio.create\\(user_id='claude_user'\\)\nprint\\(session.mcp.url\\)\n\" 2>&1)", + "Bash(pip3 install:*)", + "Bash(pip3 show:*)", + "Bash(where pip3:*)", + "Bash(C:/Python314/python.exe -c \"\nfrom composio import Composio\ncomposio = Composio\\(api_key='ak_KuIQ5_IMvfiOlKpSQjLS'\\)\nsession = composio.create\\(user_id='claude_user'\\)\nprint\\(session.mcp.url\\)\n\" 2>&1)", + "Bash(ls *.md 2>/dev/null || ls *.yaml 2>/dev/null | head -20)", + "Bash(cd \"C:\\\\Users\\\\Mahmoud\\\\awesome-claude-skills\" && python send_test_email.py)", + "mcp__claude_ai_Notion__notion-create-pages", + "mcp__claude_ai_Notion__notion-search", + "mcp__claude_ai_Notion__notion-get-users", + "mcp__mcp-registry__search_mcp_registry", + "mcp__scheduled-tasks__list_scheduled_tasks", + "Bash(python3 -c \"import PyPDF2; print\\(''PyPDF2 available''\\)\")", + "Bash(python3 -c \"import pdfplumber; print\\(''pdfplumber available''\\)\")", + "Bash(python3 -c \"import fitz; print\\(''fitz available''\\)\")", + "Bash(pip install:*)", + "Bash(python3:*)", + "mcp__141e5e9d-c7b3-42a5-8bbe-29c926554ce8__notion-create-pages", + "Bash(node -e \":*)", + "Read(//c/Users/Mahmoud/.claude/**)", + "Bash(find ~/.claude/plugins -name *.json)", + "Bash(xargs grep:*)", + "Bash(find /c/Users/Mahmoud/.claude/plugins -name *.json -path */Notion/*)", + "Bash(ls /c/Users/Mahmoud/.claude/*.json)", + "Bash(find /c/Users/Mahmoud/.claude -name credentials*)", + "Bash(env)", + "Bash(find /c/Users/Mahmoud/.claude -name *.env -o -name .env)", + "Bash(find /c/Users/Mahmoud/.claude -name *.json -exec grep -l notion {})", + "Bash(2)", + "Bash(find /c/Users/Mahmoud -maxdepth 3 -name *.env -o -name .env)", + "Bash(head -10 grep -r NOTION /c/Users/Mahmoud/.claude/ --include=*.json -l)", + "Bash(grep -r \"ntn_\\\\|secret_\\\\|NOTION_TOKEN\\\\|notion_key\" /c/Users/Mahmoud/awesome-claude-skills/ --include=*.py --include=*.env --include=*.json -l)", + "Bash(head -5 find /c/Users/Mahmoud/awesome-claude-skills -name .env*)", + "Bash(cat ~/.claude/plugins/*/settings.json)" + ] + } +} diff --git a/.claude/worktrees/amazing-moser b/.claude/worktrees/amazing-moser new file mode 160000 index 00000000..2781ab8e --- /dev/null +++ b/.claude/worktrees/amazing-moser @@ -0,0 +1 @@ +Subproject commit 2781ab8efa2e759899c28084e324c73b1e4e730d diff --git a/.claude/worktrees/brave-golick b/.claude/worktrees/brave-golick new file mode 160000 index 00000000..2781ab8e --- /dev/null +++ b/.claude/worktrees/brave-golick @@ -0,0 +1 @@ +Subproject commit 2781ab8efa2e759899c28084e324c73b1e4e730d diff --git a/.claude/worktrees/competent-hopper b/.claude/worktrees/competent-hopper new file mode 160000 index 00000000..27904475 --- /dev/null +++ b/.claude/worktrees/competent-hopper @@ -0,0 +1 @@ +Subproject commit 27904475d1270d8395acf07691966267d5abda2d diff --git a/.claude/worktrees/elastic-edison b/.claude/worktrees/elastic-edison new file mode 160000 index 00000000..431ab7e5 --- /dev/null +++ b/.claude/worktrees/elastic-edison @@ -0,0 +1 @@ +Subproject commit 431ab7e5669f224c084da50f69756ae610454e45 diff --git a/.claude/worktrees/focused-taussig b/.claude/worktrees/focused-taussig new file mode 160000 index 00000000..2781ab8e --- /dev/null +++ b/.claude/worktrees/focused-taussig @@ -0,0 +1 @@ +Subproject commit 2781ab8efa2e759899c28084e324c73b1e4e730d diff --git a/.claude/worktrees/keen-curie b/.claude/worktrees/keen-curie new file mode 160000 index 00000000..2781ab8e --- /dev/null +++ b/.claude/worktrees/keen-curie @@ -0,0 +1 @@ +Subproject commit 2781ab8efa2e759899c28084e324c73b1e4e730d diff --git a/.claude/worktrees/kind-dirac b/.claude/worktrees/kind-dirac new file mode 160000 index 00000000..27904475 --- /dev/null +++ b/.claude/worktrees/kind-dirac @@ -0,0 +1 @@ +Subproject commit 27904475d1270d8395acf07691966267d5abda2d diff --git a/.claude/worktrees/nice-dubinsky b/.claude/worktrees/nice-dubinsky new file mode 160000 index 00000000..27904475 --- /dev/null +++ b/.claude/worktrees/nice-dubinsky @@ -0,0 +1 @@ +Subproject commit 27904475d1270d8395acf07691966267d5abda2d diff --git a/.claude/worktrees/nice-merkle b/.claude/worktrees/nice-merkle new file mode 160000 index 00000000..27904475 --- /dev/null +++ b/.claude/worktrees/nice-merkle @@ -0,0 +1 @@ +Subproject commit 27904475d1270d8395acf07691966267d5abda2d diff --git a/.claude/worktrees/practical-mestorf b/.claude/worktrees/practical-mestorf new file mode 160000 index 00000000..27904475 --- /dev/null +++ b/.claude/worktrees/practical-mestorf @@ -0,0 +1 @@ +Subproject commit 27904475d1270d8395acf07691966267d5abda2d diff --git a/send_test_email.py b/send_test_email.py new file mode 100644 index 00000000..02ba704c --- /dev/null +++ b/send_test_email.py @@ -0,0 +1,20 @@ +import smtplib +from email.mime.text import MIMEText +from email.mime.multipart import MIMEMultipart + +SENDER_EMAIL = "makladmk87@gmail.com" +APP_PASSWORD = "pzbk rryf zhsw vllu" +RECIPIENT = "dt23082411@gmail.com" + +msg = MIMEMultipart() +msg["From"] = SENDER_EMAIL +msg["To"] = RECIPIENT +msg["Subject"] = "Test Email" + +msg.attach(MIMEText("This is a test email sent via Python SMTP.", "plain")) + +with smtplib.SMTP_SSL("smtp.gmail.com", 465) as server: + server.login(SENDER_EMAIL, APP_PASSWORD) + server.sendmail(SENDER_EMAIL, RECIPIENT, msg.as_string()) + +print("Email sent successfully!") From 4384fc45b36b2552c0d8a63bcf68a418c4dffc33 Mon Sep 17 00:00:00 2001 From: Mahmoud Date: Mon, 16 Mar 2026 21:47:16 +0200 Subject: [PATCH 03/75] Add .gitignore, Android install script, clean up worktrees Co-Authored-By: Claude Sonnet 4.6 --- .claude/worktrees/amazing-moser | 1 - .claude/worktrees/brave-golick | 1 - .claude/worktrees/competent-hopper | 1 - .claude/worktrees/elastic-edison | 1 - .claude/worktrees/focused-taussig | 1 - .claude/worktrees/keen-curie | 1 - .claude/worktrees/kind-dirac | 1 - .claude/worktrees/nice-dubinsky | 1 - .claude/worktrees/nice-merkle | 1 - .claude/worktrees/practical-mestorf | 1 - .gitignore | 11 +++++ install.sh | 65 +++++++++++++++++++++++++++++ 12 files changed, 76 insertions(+), 10 deletions(-) delete mode 160000 .claude/worktrees/amazing-moser delete mode 160000 .claude/worktrees/brave-golick delete mode 160000 .claude/worktrees/competent-hopper delete mode 160000 .claude/worktrees/elastic-edison delete mode 160000 .claude/worktrees/focused-taussig delete mode 160000 .claude/worktrees/keen-curie delete mode 160000 .claude/worktrees/kind-dirac delete mode 160000 .claude/worktrees/nice-dubinsky delete mode 160000 .claude/worktrees/nice-merkle delete mode 160000 .claude/worktrees/practical-mestorf create mode 100644 .gitignore create mode 100644 install.sh diff --git a/.claude/worktrees/amazing-moser b/.claude/worktrees/amazing-moser deleted file mode 160000 index 2781ab8e..00000000 --- a/.claude/worktrees/amazing-moser +++ /dev/null @@ -1 +0,0 @@ -Subproject commit 2781ab8efa2e759899c28084e324c73b1e4e730d diff --git a/.claude/worktrees/brave-golick b/.claude/worktrees/brave-golick deleted file mode 160000 index 2781ab8e..00000000 --- a/.claude/worktrees/brave-golick +++ /dev/null @@ -1 +0,0 @@ -Subproject commit 2781ab8efa2e759899c28084e324c73b1e4e730d diff --git a/.claude/worktrees/competent-hopper b/.claude/worktrees/competent-hopper deleted file mode 160000 index 27904475..00000000 --- a/.claude/worktrees/competent-hopper +++ /dev/null @@ -1 +0,0 @@ -Subproject commit 27904475d1270d8395acf07691966267d5abda2d diff --git a/.claude/worktrees/elastic-edison b/.claude/worktrees/elastic-edison deleted file mode 160000 index 431ab7e5..00000000 --- a/.claude/worktrees/elastic-edison +++ /dev/null @@ -1 +0,0 @@ -Subproject commit 431ab7e5669f224c084da50f69756ae610454e45 diff --git a/.claude/worktrees/focused-taussig b/.claude/worktrees/focused-taussig deleted file mode 160000 index 2781ab8e..00000000 --- a/.claude/worktrees/focused-taussig +++ /dev/null @@ -1 +0,0 @@ -Subproject commit 2781ab8efa2e759899c28084e324c73b1e4e730d diff --git a/.claude/worktrees/keen-curie b/.claude/worktrees/keen-curie deleted file mode 160000 index 2781ab8e..00000000 --- a/.claude/worktrees/keen-curie +++ /dev/null @@ -1 +0,0 @@ -Subproject commit 2781ab8efa2e759899c28084e324c73b1e4e730d diff --git a/.claude/worktrees/kind-dirac b/.claude/worktrees/kind-dirac deleted file mode 160000 index 27904475..00000000 --- a/.claude/worktrees/kind-dirac +++ /dev/null @@ -1 +0,0 @@ -Subproject commit 27904475d1270d8395acf07691966267d5abda2d diff --git a/.claude/worktrees/nice-dubinsky b/.claude/worktrees/nice-dubinsky deleted file mode 160000 index 27904475..00000000 --- a/.claude/worktrees/nice-dubinsky +++ /dev/null @@ -1 +0,0 @@ -Subproject commit 27904475d1270d8395acf07691966267d5abda2d diff --git a/.claude/worktrees/nice-merkle b/.claude/worktrees/nice-merkle deleted file mode 160000 index 27904475..00000000 --- a/.claude/worktrees/nice-merkle +++ /dev/null @@ -1 +0,0 @@ -Subproject commit 27904475d1270d8395acf07691966267d5abda2d diff --git a/.claude/worktrees/practical-mestorf b/.claude/worktrees/practical-mestorf deleted file mode 160000 index 27904475..00000000 --- a/.claude/worktrees/practical-mestorf +++ /dev/null @@ -1 +0,0 @@ -Subproject commit 27904475d1270d8395acf07691966267d5abda2d diff --git a/.gitignore b/.gitignore new file mode 100644 index 00000000..9ca40080 --- /dev/null +++ b/.gitignore @@ -0,0 +1,11 @@ +# Claude Code local files +.claude/settings.local.json +.claude/worktrees/ +.claude/todos/ + +# OS +.DS_Store +Thumbs.db + +# Node +node_modules/ diff --git a/install.sh b/install.sh new file mode 100644 index 00000000..7eef12ca --- /dev/null +++ b/install.sh @@ -0,0 +1,65 @@ +#!/bin/bash +# ================================================ +# Claude Code Skills Setup - Android (Termux) +# Usage: bash install.sh +# ================================================ + +set -e + +REPO="https://github.com/makladmk87-max/awesome-claude-skills" +SKILLS_DIR="$HOME/.claude/skills" +REPO_DIR="$HOME/awesome-claude-skills" + +echo "==> Setting up Claude Code skills on Android..." + +# ── 1. Install dependencies (Termux) ────────────────────────────────────────── +if command -v pkg &>/dev/null; then + echo "==> Installing packages via Termux..." + pkg update -y + pkg install -y git nodejs +elif command -v apt-get &>/dev/null; then + echo "==> Installing packages via apt..." + apt-get update -y + apt-get install -y git nodejs npm +fi + +# ── 2. Install Claude Code CLI ───────────────────────────────────────────────── +if ! command -v claude &>/dev/null; then + echo "==> Installing Claude Code CLI..." + npm install -g @anthropic-ai/claude-code +else + echo "==> Claude Code already installed: $(claude --version)" +fi + +# ── 3. Clone or update the skills repo ──────────────────────────────────────── +if [ -d "$REPO_DIR/.git" ]; then + echo "==> Updating existing repo..." + git -C "$REPO_DIR" pull +else + echo "==> Cloning skills repo..." + git clone "$REPO" "$REPO_DIR" +fi + +# ── 4. Link skills into ~/.claude/skills ────────────────────────────────────── +mkdir -p "$SKILLS_DIR" + +echo "==> Installing skills..." +for skill_dir in "$REPO_DIR"/*/; do + skill_name=$(basename "$skill_dir") + skill_file="$skill_dir/SKILL.md" + + # Skip non-skill directories + if [ ! -f "$skill_file" ]; then + continue + fi + + target="$SKILLS_DIR/$skill_name.md" + cp "$skill_file" "$target" + echo " + $skill_name" +done + +echo "" +echo "✓ Done! Skills installed to $SKILLS_DIR" +echo "" +echo "To use Claude Code, run: claude" +echo "To update skills later, run: bash $REPO_DIR/install.sh" From 9e498262dc3067662a3c4d3dd8cfc3b7cf1f3895 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:54:29 +0200 Subject: [PATCH 04/75] Add superpowers-brainstorming skill --- superpowers-brainstorming/SKILL.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 superpowers-brainstorming/SKILL.md diff --git a/superpowers-brainstorming/SKILL.md b/superpowers-brainstorming/SKILL.md new file mode 100644 index 00000000..6fad413e --- /dev/null +++ b/superpowers-brainstorming/SKILL.md @@ -0,0 +1,24 @@ +--- +name: superpowers:brainstorming +description: MUST be used before any creative work — creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements, and design constraints before implementation begins. +--- + +## superpowers:brainstorming +**Category:** Superpowers — Core Workflow + +**What it does:** +MUST be used before any creative work — creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements, and design constraints before implementation begins. Prevents wasted effort by aligning on the right approach upfront. + +**When to trigger:** +- Before building any new feature +- Before any `/gsd:plan-phase` +- Whenever entering plan mode + +**How to install:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** Automatically triggered before creative implementation work. Also: `/superpowers:brainstorming` + +> **Note:** `superpowers:brainstorm` is the deprecated alias — use `superpowers:brainstorming` instead. From 08d37904093bcb6272415f94f27d80fd3edeef48 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:54:42 +0200 Subject: [PATCH 05/75] Add superpowers-writing-plans skill --- superpowers-writing-plans/SKILL.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 superpowers-writing-plans/SKILL.md diff --git a/superpowers-writing-plans/SKILL.md b/superpowers-writing-plans/SKILL.md new file mode 100644 index 00000000..75174b1c --- /dev/null +++ b/superpowers-writing-plans/SKILL.md @@ -0,0 +1,23 @@ +--- +name: superpowers:writing-plans +description: Use when you have a spec or requirements for a multi-step task, before touching any code. Structures a detailed implementation plan covering architecture decisions, file changes, dependencies, and sequencing. +--- + +## superpowers:writing-plans +**Category:** Superpowers — Core Workflow + +**What it does:** +Use when you have a spec or requirements for a multi-step task, before touching any code. Structures a detailed implementation plan covering architecture decisions, file changes, dependencies, and sequencing. + +**When to trigger:** +- You have requirements and are about to start coding +- Before entering plan mode on a complex feature + +**How to install:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/superpowers:writing-plans` + +> **Note:** `superpowers:write-plan` is the deprecated alias. From 985fe3d2e98ba88e5d8224eaf7116c945bc2e712 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:54:43 +0200 Subject: [PATCH 06/75] Add superpowers-executing-plans skill --- superpowers-executing-plans/SKILL.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 superpowers-executing-plans/SKILL.md diff --git a/superpowers-executing-plans/SKILL.md b/superpowers-executing-plans/SKILL.md new file mode 100644 index 00000000..31f8e1b8 --- /dev/null +++ b/superpowers-executing-plans/SKILL.md @@ -0,0 +1,22 @@ +--- +name: superpowers:executing-plans +description: Use when you have a written implementation plan to execute in a separate session with review checkpoints. Ensures disciplined execution with steps, commit checkpoints, and review before proceeding. +--- + +## superpowers:executing-plans +**Category:** Superpowers — Core Workflow + +**What it does:** +Use when you have a written implementation plan to execute in a separate session with review checkpoints. Ensures disciplined execution: work in steps, commit checkpoints, and review before proceeding. + +**When to trigger:** +When you have a written plan and want to execute it. + +**How to install:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/superpowers:executing-plans` + +> **Note:** `superpowers:execute-plan` is the deprecated alias. From 183d6cf9185510b616e0d94952d27da652aac6f3 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:54:44 +0200 Subject: [PATCH 07/75] Add superpowers-dispatching-parallel-agents skill --- .../SKILL.md | 22 +++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 superpowers-dispatching-parallel-agents/SKILL.md diff --git a/superpowers-dispatching-parallel-agents/SKILL.md b/superpowers-dispatching-parallel-agents/SKILL.md new file mode 100644 index 00000000..ce27864f --- /dev/null +++ b/superpowers-dispatching-parallel-agents/SKILL.md @@ -0,0 +1,22 @@ +--- +name: superpowers:dispatching-parallel-agents +description: Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies. Orchestrates multiple Claude subagents running in parallel to dramatically speed up execution. +--- + +## superpowers:dispatching-parallel-agents +**Category:** Superpowers — Core Workflow + +**What it does:** +Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies. Orchestrates multiple Claude subagents running in parallel, dramatically speeding up execution. + +**When to trigger:** +- You have multiple independent tasks +- Research across several unrelated topics +- Building parallel features with no shared state + +**How to install:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/superpowers:dispatching-parallel-agents` From 8e20ce30edf1f357ef13fff55bfd91f5d07659bc Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:54:45 +0200 Subject: [PATCH 08/75] Add superpowers-using-git-worktrees skill --- superpowers-using-git-worktrees/SKILL.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 superpowers-using-git-worktrees/SKILL.md diff --git a/superpowers-using-git-worktrees/SKILL.md b/superpowers-using-git-worktrees/SKILL.md new file mode 100644 index 00000000..153c9e9d --- /dev/null +++ b/superpowers-using-git-worktrees/SKILL.md @@ -0,0 +1,21 @@ +--- +name: superpowers:using-git-worktrees +description: Use when starting feature work that needs isolation from the current workspace, or before executing implementation plans. Creates isolated git worktrees so experiments never pollute the main branch. +--- + +## superpowers:using-git-worktrees +**Category:** Superpowers — Core Workflow + +**What it does:** +Use when starting feature work that needs isolation from the current workspace, or before executing implementation plans. Creates isolated git worktrees with smart directory selection and safety verification — so experiments never pollute the main branch. + +**When to trigger:** +- Starting isolated feature work +- Before executing a large implementation plan + +**How to install:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/superpowers:using-git-worktrees` From 9d3ae84e84b5ddd052313513f92e36e4128294e8 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:54:45 +0200 Subject: [PATCH 09/75] Add superpowers-test-driven-development skill --- superpowers-test-driven-development/SKILL.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 superpowers-test-driven-development/SKILL.md diff --git a/superpowers-test-driven-development/SKILL.md b/superpowers-test-driven-development/SKILL.md new file mode 100644 index 00000000..89ed2ef5 --- /dev/null +++ b/superpowers-test-driven-development/SKILL.md @@ -0,0 +1,20 @@ +--- +name: superpowers:test-driven-development +description: Use when implementing any feature or bugfix, before writing implementation code. Follows strict TDD — write failing tests first, then make them pass. This is a rigid skill — follow it exactly. +--- + +## superpowers:test-driven-development +**Category:** Superpowers — Core Workflow + +**What it does:** +Use when implementing any feature or bugfix, before writing implementation code. Follows strict TDD: write failing tests first, then make them pass. This is a **rigid skill** — follow it exactly. + +**When to trigger:** +Before writing implementation code for any feature or fix. + +**How to install:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/superpowers:test-driven-development` From e5b6613dbea8e3c70e39e7aa8f0f90c7b4b96921 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:54:46 +0200 Subject: [PATCH 10/75] Add superpowers-using-superpowers skill --- superpowers-using-superpowers/SKILL.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 superpowers-using-superpowers/SKILL.md diff --git a/superpowers-using-superpowers/SKILL.md b/superpowers-using-superpowers/SKILL.md new file mode 100644 index 00000000..8772faef --- /dev/null +++ b/superpowers-using-superpowers/SKILL.md @@ -0,0 +1,22 @@ +--- +name: superpowers:using-superpowers +description: The master skill — establishes how to find and use all other skills. Loaded at the start of every conversation. Defines when and how to invoke skills, skill priority order, and red flags for rationalizing away skill invocations. +--- + +## superpowers:using-superpowers +**Category:** Superpowers — Meta + +**What it does:** +The master skill — establishes how to find and use all other skills. Loaded at the start of every conversation. Defines when and how to invoke skills, the skill priority order, and red flags that indicate you're rationalizing away a skill invocation. + +**Key rules it enforces:** +- Invoke relevant skills BEFORE any response +- Even 1% chance a skill applies → invoke it +- Process skills (brainstorming, debugging) before implementation skills + +**How to install:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** Automatically loaded at session start. From 2d5066d35b01e3fd571870b72bd5113e94b763ed Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:54:47 +0200 Subject: [PATCH 11/75] Add superpowers-systematic-debugging skill --- superpowers-systematic-debugging/SKILL.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 superpowers-systematic-debugging/SKILL.md diff --git a/superpowers-systematic-debugging/SKILL.md b/superpowers-systematic-debugging/SKILL.md new file mode 100644 index 00000000..552c3cec --- /dev/null +++ b/superpowers-systematic-debugging/SKILL.md @@ -0,0 +1,22 @@ +--- +name: superpowers:systematic-debugging +description: Use when encountering any bug, test failure, or unexpected behavior — before proposing fixes. Uses a structured scientific method to prevent jumping to the wrong fix. +--- + +## superpowers:systematic-debugging +**Category:** Superpowers — Core Workflow + +**What it does:** +Use when encountering any bug, test failure, or unexpected behavior — before proposing fixes. Uses a structured scientific method: observe → hypothesize → test → conclude. Prevents jumping to the wrong fix. + +**When to trigger:** +- Any bug or test failure +- Unexpected behavior in code +- Before running `gsd:debug` + +**How to install:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/superpowers:systematic-debugging` From daa18abb2faf692b1823d11967f4df7418affd93 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:54:48 +0200 Subject: [PATCH 12/75] Add superpowers-writing-skills skill --- superpowers-writing-skills/SKILL.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 superpowers-writing-skills/SKILL.md diff --git a/superpowers-writing-skills/SKILL.md b/superpowers-writing-skills/SKILL.md new file mode 100644 index 00000000..8d454ade --- /dev/null +++ b/superpowers-writing-skills/SKILL.md @@ -0,0 +1,22 @@ +--- +name: superpowers:writing-skills +description: Use when creating new skills, editing existing skills, or verifying skills work before deployment. Guides the correct structure, frontmatter, trigger conditions, and testing methodology for Claude Code skills. +--- + +## superpowers:writing-skills +**Category:** Superpowers — Meta + +**What it does:** +Use when creating new skills, editing existing skills, or verifying skills work before deployment. Guides the correct structure, frontmatter, trigger conditions, and testing methodology for Claude Code skills. + +**When to trigger:** +- Writing a new skill +- Editing or improving an existing skill +- Verifying a skill's behavior + +**How to install:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/superpowers:writing-skills` From 3726e394efb5285845c8cb211e61e13d74810fac Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:54:49 +0200 Subject: [PATCH 13/75] Add superpowers-subagent-driven-development skill --- .../SKILL.md | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 superpowers-subagent-driven-development/SKILL.md diff --git a/superpowers-subagent-driven-development/SKILL.md b/superpowers-subagent-driven-development/SKILL.md new file mode 100644 index 00000000..f6cbefdc --- /dev/null +++ b/superpowers-subagent-driven-development/SKILL.md @@ -0,0 +1,20 @@ +--- +name: superpowers:subagent-driven-development +description: Use when executing implementation plans with independent tasks in the current session. Coordinates subagents within the current Claude Code session. +--- + +## superpowers:subagent-driven-development +**Category:** Superpowers — Core Workflow + +**What it does:** +Use when executing implementation plans with independent tasks in the current session. Coordinates subagents within the current Claude Code session (unlike `dispatching-parallel-agents` which spawns external processes). + +**When to trigger:** +When you have a plan with multiple independent implementation tasks. + +**How to install:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/superpowers:subagent-driven-development` From d12710d823d0aaa0fc130f56b3527055619b8b85 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:54:49 +0200 Subject: [PATCH 14/75] Add superpowers-requesting-code-review skill --- superpowers-requesting-code-review/SKILL.md | 22 +++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 superpowers-requesting-code-review/SKILL.md diff --git a/superpowers-requesting-code-review/SKILL.md b/superpowers-requesting-code-review/SKILL.md new file mode 100644 index 00000000..072c7679 --- /dev/null +++ b/superpowers-requesting-code-review/SKILL.md @@ -0,0 +1,22 @@ +--- +name: superpowers:requesting-code-review +description: Use when completing tasks, implementing major features, or before merging — to verify work meets requirements. Structures the code review request to ensure meaningful feedback. +--- + +## superpowers:requesting-code-review +**Category:** Superpowers — Quality + +**What it does:** +Use when completing tasks, implementing major features, or before merging — to verify work meets requirements. Structures the code review request to ensure meaningful feedback. + +**When to trigger:** +- After completing a feature +- Before merging a branch +- After a major implementation step + +**How to install:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/superpowers:requesting-code-review` From aa3b68ae5bc17e07c2a8ee521c77c79e3f49b63e Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:54:50 +0200 Subject: [PATCH 15/75] Add superpowers-receiving-code-review skill --- superpowers-receiving-code-review/SKILL.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 superpowers-receiving-code-review/SKILL.md diff --git a/superpowers-receiving-code-review/SKILL.md b/superpowers-receiving-code-review/SKILL.md new file mode 100644 index 00000000..bd2e50b0 --- /dev/null +++ b/superpowers-receiving-code-review/SKILL.md @@ -0,0 +1,21 @@ +--- +name: superpowers:receiving-code-review +description: Use when receiving code review feedback, before implementing suggestions — especially if feedback seems unclear or technically questionable. Requires technical rigor rather than blind implementation. +--- + +## superpowers:receiving-code-review +**Category:** Superpowers — Quality + +**What it does:** +Use when receiving code review feedback, before implementing suggestions — especially if feedback seems unclear or technically questionable. Requires technical rigor and verification rather than performative agreement or blind implementation. + +**When to trigger:** +- After getting code review comments +- Before implementing review suggestions + +**How to install:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/superpowers:receiving-code-review` From 1170fb19662dacea868f2da58f142cfff66426ed Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:54:51 +0200 Subject: [PATCH 16/75] Add superpowers-finishing-a-development-branch skill --- .../SKILL.md | 21 +++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 superpowers-finishing-a-development-branch/SKILL.md diff --git a/superpowers-finishing-a-development-branch/SKILL.md b/superpowers-finishing-a-development-branch/SKILL.md new file mode 100644 index 00000000..c7e77e5d --- /dev/null +++ b/superpowers-finishing-a-development-branch/SKILL.md @@ -0,0 +1,21 @@ +--- +name: superpowers:finishing-a-development-branch +description: Use when implementation is complete, all tests pass, and you need to decide how to integrate the work. Guides completion by presenting structured options — merge, PR, or cleanup. +--- + +## superpowers:finishing-a-development-branch +**Category:** Superpowers — Quality + +**What it does:** +Use when implementation is complete, all tests pass, and you need to decide how to integrate the work. Guides completion by presenting structured options: merge, PR, or cleanup. + +**When to trigger:** +- Implementation done, tests passing +- Ready to integrate a feature branch + +**How to install:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/superpowers:finishing-a-development-branch` From e1a47ea2dd8801e92d6544d45fd3ad971a2fb24f Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:54:52 +0200 Subject: [PATCH 17/75] Add superpowers-verification-before-completion skill --- .../SKILL.md | 22 +++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 superpowers-verification-before-completion/SKILL.md diff --git a/superpowers-verification-before-completion/SKILL.md b/superpowers-verification-before-completion/SKILL.md new file mode 100644 index 00000000..0db73ba0 --- /dev/null +++ b/superpowers-verification-before-completion/SKILL.md @@ -0,0 +1,22 @@ +--- +name: superpowers:verification-before-completion +description: Use when about to claim work is complete, fixed, or passing — before committing or creating PRs. Requires running verification commands and confirming output before making any success claims. +--- + +## superpowers:verification-before-completion +**Category:** Superpowers — Quality + +**What it does:** +Use when about to claim work is complete, fixed, or passing — before committing or creating PRs. Requires running verification commands and confirming output before making any success claims. Evidence before assertions, always. + +**When to trigger:** +- Before saying "it works" +- Before committing +- Before creating a PR + +**How to install:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/superpowers:verification-before-completion` From f50716907d4db87a147a9ec012e3635688c04ba8 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:11 +0200 Subject: [PATCH 18/75] Add gsd-add-tests skill --- gsd-add-tests/SKILL.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 gsd-add-tests/SKILL.md diff --git a/gsd-add-tests/SKILL.md b/gsd-add-tests/SKILL.md new file mode 100644 index 00000000..daf3e5bf --- /dev/null +++ b/gsd-add-tests/SKILL.md @@ -0,0 +1,24 @@ +--- +name: gsd:add-tests +description: Generates tests for a completed phase based on UAT criteria and the actual implementation. Ensures your code is properly covered after a phase finishes. +--- + +## gsd:add-tests +**Category:** GSD (Get Stuff Done) + +**What it does:** +Generates tests for a completed phase based on UAT (User Acceptance Testing) criteria and the actual implementation. Ensures your code is properly covered after a phase finishes. + +**When to trigger:** +After completing a GSD phase and wanting to add test coverage. + +**How to install GSD:** +```bash +npx claude install superpowers +``` +Then in Claude Code: +``` +/gsd:update +``` + +**Trigger phrase:** `/gsd:add-tests` — run after a phase is done to generate tests. From 6a83f55485e7833a97c0fbdf42ffa1f3926c60d2 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:12 +0200 Subject: [PATCH 19/75] Add gsd-add-phase skill --- gsd-add-phase/SKILL.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 gsd-add-phase/SKILL.md diff --git a/gsd-add-phase/SKILL.md b/gsd-add-phase/SKILL.md new file mode 100644 index 00000000..37e334e7 --- /dev/null +++ b/gsd-add-phase/SKILL.md @@ -0,0 +1,17 @@ +--- +name: gsd:add-phase +description: Adds a new phase to the end of the current milestone in your project roadmap. Use when you realize you need additional work that wasn't in the original plan. +--- + +## gsd:add-phase +**Category:** GSD (Get Stuff Done) + +**What it does:** +Adds a new phase to the end of the current milestone in your project roadmap. Use this when you realize you need additional work that wasn't in the original plan. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:add-phase` From 27cd2ed60245d9483d8c80b39987359f74247eba Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:13 +0200 Subject: [PATCH 20/75] Add gsd-check-todos skill --- gsd-check-todos/SKILL.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 gsd-check-todos/SKILL.md diff --git a/gsd-check-todos/SKILL.md b/gsd-check-todos/SKILL.md new file mode 100644 index 00000000..81e771ed --- /dev/null +++ b/gsd-check-todos/SKILL.md @@ -0,0 +1,17 @@ +--- +name: gsd:check-todos +description: Lists all pending todos and lets you select one to work on. Gives you a quick overview of outstanding items so you can prioritize what to tackle next. +--- + +## gsd:check-todos +**Category:** GSD (Get Stuff Done) + +**What it does:** +Lists all pending todos and lets you select one to work on. Gives you a quick overview of outstanding items so you can prioritize what to tackle next. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:check-todos` From f5cafd5e60f0aa6ac52f33f0a694dc285805dbc1 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:14 +0200 Subject: [PATCH 21/75] Add gsd-audit-milestone skill --- gsd-audit-milestone/SKILL.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 gsd-audit-milestone/SKILL.md diff --git a/gsd-audit-milestone/SKILL.md b/gsd-audit-milestone/SKILL.md new file mode 100644 index 00000000..aad4aaab --- /dev/null +++ b/gsd-audit-milestone/SKILL.md @@ -0,0 +1,20 @@ +--- +name: gsd:audit-milestone +description: Audits a milestone's completion against its original intent before archiving it. Checks whether what was built actually matches what was planned, not just that tasks were checked off. +--- + +## gsd:audit-milestone +**Category:** GSD (Get Stuff Done) + +**What it does:** +Audits a milestone's completion against its original intent before archiving it. Checks whether what was built actually matches what was planned, not just that tasks were checked off. + +**When to trigger:** +Before archiving a milestone. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:audit-milestone` From a46b8a64aa1b6ec3620c3dd608cf23ee126dd002 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:15 +0200 Subject: [PATCH 22/75] Add gsd-add-todo skill --- gsd-add-todo/SKILL.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 gsd-add-todo/SKILL.md diff --git a/gsd-add-todo/SKILL.md b/gsd-add-todo/SKILL.md new file mode 100644 index 00000000..f43bc799 --- /dev/null +++ b/gsd-add-todo/SKILL.md @@ -0,0 +1,17 @@ +--- +name: gsd:add-todo +description: Captures an idea or task as a todo directly from the current conversation context. Quick way to log something without losing it mid-session. +--- + +## gsd:add-todo +**Category:** GSD (Get Stuff Done) + +**What it does:** +Captures an idea or task as a todo directly from the current conversation context. Quick way to log something without losing it mid-session. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:add-todo` From 2be1ba902f8d76e9afd90a9d3ab895b50929795b Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:16 +0200 Subject: [PATCH 23/75] Add gsd-complete-milestone skill --- gsd-complete-milestone/SKILL.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 gsd-complete-milestone/SKILL.md diff --git a/gsd-complete-milestone/SKILL.md b/gsd-complete-milestone/SKILL.md new file mode 100644 index 00000000..205c23c7 --- /dev/null +++ b/gsd-complete-milestone/SKILL.md @@ -0,0 +1,20 @@ +--- +name: gsd:complete-milestone +description: Archives a completed milestone and prepares the project for the next version. Wraps up loose ends and sets the stage for the next cycle. +--- + +## gsd:complete-milestone +**Category:** GSD (Get Stuff Done) + +**What it does:** +Archives a completed milestone and prepares the project for the next version. Wraps up loose ends and sets the stage for the next cycle. + +**When to trigger:** +After all phases in a milestone are done. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:complete-milestone` From 63c5b3b3b2e813cf0a5440e1e03e19b0adbe232d Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:17 +0200 Subject: [PATCH 24/75] Add gsd-cleanup skill --- gsd-cleanup/SKILL.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 gsd-cleanup/SKILL.md diff --git a/gsd-cleanup/SKILL.md b/gsd-cleanup/SKILL.md new file mode 100644 index 00000000..ebf1a1bc --- /dev/null +++ b/gsd-cleanup/SKILL.md @@ -0,0 +1,17 @@ +--- +name: gsd:cleanup +description: Archives accumulated phase directories from completed milestones, keeping your .planning/ directory tidy. +--- + +## gsd:cleanup +**Category:** GSD (Get Stuff Done) + +**What it does:** +Archives accumulated phase directories from completed milestones, keeping your `.planning/` directory tidy. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:cleanup` From 25ec2751c8061d0add70fcdcdab389f18a5f89e3 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:17 +0200 Subject: [PATCH 25/75] Add gsd-debug skill --- gsd-debug/SKILL.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 gsd-debug/SKILL.md diff --git a/gsd-debug/SKILL.md b/gsd-debug/SKILL.md new file mode 100644 index 00000000..3fd37dcc --- /dev/null +++ b/gsd-debug/SKILL.md @@ -0,0 +1,20 @@ +--- +name: gsd:debug +description: Systematic debugging with persistent state across context resets. Uses a scientific method approach with a debug session log so you don't lose progress when context resets. +--- + +## gsd:debug +**Category:** GSD (Get Stuff Done) + +**What it does:** +Systematic debugging with persistent state across context resets. Uses a scientific method approach: hypothesis → test → conclusion. Maintains a debug session log so you don't lose progress when context resets. + +**When to trigger:** +When you have a bug that needs structured investigation. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:debug` — for persistent, structured bug investigation. From a01b0e48b8ec3556df74b5decc82e596ddb44e91 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:18 +0200 Subject: [PATCH 26/75] Add gsd-discuss-phase skill --- gsd-discuss-phase/SKILL.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 gsd-discuss-phase/SKILL.md diff --git a/gsd-discuss-phase/SKILL.md b/gsd-discuss-phase/SKILL.md new file mode 100644 index 00000000..a58e1e40 --- /dev/null +++ b/gsd-discuss-phase/SKILL.md @@ -0,0 +1,20 @@ +--- +name: gsd:discuss-phase +description: Gathers phase context through adaptive questioning before planning begins. Ensures Claude fully understands the goals and constraints of a phase before writing a plan. +--- + +## gsd:discuss-phase +**Category:** GSD (Get Stuff Done) + +**What it does:** +Gathers phase context through adaptive questioning before planning begins. Ensures Claude fully understands the goals and constraints of a phase before writing a plan. + +**When to trigger:** +Before planning a phase, when you want to have a discussion first. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:discuss-phase` From f9a5d11a2f61db7b45dc6be21155b5b461adf5b1 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:19 +0200 Subject: [PATCH 27/75] Add gsd-execute-phase skill --- gsd-execute-phase/SKILL.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 gsd-execute-phase/SKILL.md diff --git a/gsd-execute-phase/SKILL.md b/gsd-execute-phase/SKILL.md new file mode 100644 index 00000000..0823c0fb --- /dev/null +++ b/gsd-execute-phase/SKILL.md @@ -0,0 +1,20 @@ +--- +name: gsd:execute-phase +description: Executes all plans in a phase using wave-based parallelization. Spawns multiple subagents to work on independent tasks simultaneously — the core execution engine of GSD. +--- + +## gsd:execute-phase +**Category:** GSD (Get Stuff Done) + +**What it does:** +Executes all plans in a phase using wave-based parallelization. Spawns multiple subagents to work on independent tasks simultaneously, then merges results. The core execution engine of GSD. + +**When to trigger:** +After a phase is planned and ready to execute. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:execute-phase` From 6320c6c80b270a37e656a22f62853816d4a9d2ec Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:20 +0200 Subject: [PATCH 28/75] Add gsd-help skill --- gsd-help/SKILL.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 gsd-help/SKILL.md diff --git a/gsd-help/SKILL.md b/gsd-help/SKILL.md new file mode 100644 index 00000000..c652fc20 --- /dev/null +++ b/gsd-help/SKILL.md @@ -0,0 +1,17 @@ +--- +name: gsd:help +description: Shows all available GSD commands and a usage guide. Your starting point for learning the GSD workflow. +--- + +## gsd:help +**Category:** GSD (Get Stuff Done) + +**What it does:** +Shows all available GSD commands and a usage guide. Your starting point for learning the GSD workflow. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:help` From f3b72dae1fed64b30049c47851cb37cf71e491e7 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:21 +0200 Subject: [PATCH 29/75] Add gsd-health skill --- gsd-health/SKILL.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 gsd-health/SKILL.md diff --git a/gsd-health/SKILL.md b/gsd-health/SKILL.md new file mode 100644 index 00000000..a2c00680 --- /dev/null +++ b/gsd-health/SKILL.md @@ -0,0 +1,17 @@ +--- +name: gsd:health +description: Diagnoses the health of your .planning/ directory and optionally repairs issues. Useful when something seems off with your project structure. +--- + +## gsd:health +**Category:** GSD (Get Stuff Done) + +**What it does:** +Diagnoses the health of your `.planning/` directory and optionally repairs issues. Useful when something seems off with your project structure. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:health` From 07e115ddcfdef85d1af6afcabcc9aa80dfa9e560 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:22 +0200 Subject: [PATCH 30/75] Add gsd-insert-phase skill --- gsd-insert-phase/SKILL.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 gsd-insert-phase/SKILL.md diff --git a/gsd-insert-phase/SKILL.md b/gsd-insert-phase/SKILL.md new file mode 100644 index 00000000..aa01630e --- /dev/null +++ b/gsd-insert-phase/SKILL.md @@ -0,0 +1,17 @@ +--- +name: gsd:insert-phase +description: Inserts urgent work as a decimal phase (e.g., 7.1) between two existing phases without renumbering the whole roadmap. Perfect for hotfixes or urgent additions. +--- + +## gsd:insert-phase +**Category:** GSD (Get Stuff Done) + +**What it does:** +Inserts urgent work as a decimal phase (e.g., `7.1`) between two existing phases, without renumbering the whole roadmap. Perfect for hotfixes or urgent additions. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:insert-phase` From 8cc8db3b376ab53354cf239d8ca54f46aef806c3 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:23 +0200 Subject: [PATCH 31/75] Add gsd-join-discord skill --- gsd-join-discord/SKILL.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 gsd-join-discord/SKILL.md diff --git a/gsd-join-discord/SKILL.md b/gsd-join-discord/SKILL.md new file mode 100644 index 00000000..5f852b94 --- /dev/null +++ b/gsd-join-discord/SKILL.md @@ -0,0 +1,17 @@ +--- +name: gsd:join-discord +description: Joins you to the GSD Discord community — a place to get help, share projects, and connect with other GSD users. +--- + +## gsd:join-discord +**Category:** GSD (Get Stuff Done) + +**What it does:** +Joins you to the GSD Discord community — a place to get help, share projects, and connect with other GSD users. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:join-discord` From 3cc6f20ff9c3347f760a7b4c6f282b21a34164d1 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:23 +0200 Subject: [PATCH 32/75] Add gsd-pause-work skill --- gsd-pause-work/SKILL.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 gsd-pause-work/SKILL.md diff --git a/gsd-pause-work/SKILL.md b/gsd-pause-work/SKILL.md new file mode 100644 index 00000000..7a817a5a --- /dev/null +++ b/gsd-pause-work/SKILL.md @@ -0,0 +1,20 @@ +--- +name: gsd:pause-work +description: Creates a context handoff document when you need to pause work mid-phase. Saves your current state so you or Claude can resume exactly where you left off. +--- + +## gsd:pause-work +**Category:** GSD (Get Stuff Done) + +**What it does:** +Creates a context handoff document when you need to pause work mid-phase. Saves your current state so you or Claude can resume exactly where you left off in a future session. + +**When to trigger:** +When you need to stop working mid-phase. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:pause-work` From 9984667cc595a7d63c55174d0481c2789b15636b Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:24 +0200 Subject: [PATCH 33/75] Add gsd-new-project skill --- gsd-new-project/SKILL.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 gsd-new-project/SKILL.md diff --git a/gsd-new-project/SKILL.md b/gsd-new-project/SKILL.md new file mode 100644 index 00000000..63f68a0b --- /dev/null +++ b/gsd-new-project/SKILL.md @@ -0,0 +1,20 @@ +--- +name: gsd:new-project +description: Initializes a brand new project with deep context gathering and a PROJECT.md file. Runs parallel research agents, creates a full roadmap, and sets up your .planning/ directory. +--- + +## gsd:new-project +**Category:** GSD (Get Stuff Done) + +**What it does:** +Initializes a brand new project with deep context gathering and a `PROJECT.md` file. Runs parallel research agents, creates a full roadmap, and sets up your `.planning/` directory. + +**When to trigger:** +At the very start of a new project. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:new-project` From 57e73055e0b052902d5a5482ac7dfc72afc53065 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:25 +0200 Subject: [PATCH 34/75] Add gsd-new-milestone skill --- gsd-new-milestone/SKILL.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 gsd-new-milestone/SKILL.md diff --git a/gsd-new-milestone/SKILL.md b/gsd-new-milestone/SKILL.md new file mode 100644 index 00000000..9bab54c2 --- /dev/null +++ b/gsd-new-milestone/SKILL.md @@ -0,0 +1,17 @@ +--- +name: gsd:new-milestone +description: Starts a new milestone cycle by updating PROJECT.md and routing to requirements gathering. Use after completing one milestone and starting the next. +--- + +## gsd:new-milestone +**Category:** GSD (Get Stuff Done) + +**What it does:** +Starts a new milestone cycle by updating `PROJECT.md` and routing to requirements gathering. Use after completing one milestone and starting the next. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:new-milestone` From ef8b86f167dcdad15511762a5e17d13ad328326f Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:26 +0200 Subject: [PATCH 35/75] Add gsd-map-codebase skill --- gsd-map-codebase/SKILL.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 gsd-map-codebase/SKILL.md diff --git a/gsd-map-codebase/SKILL.md b/gsd-map-codebase/SKILL.md new file mode 100644 index 00000000..d5affee6 --- /dev/null +++ b/gsd-map-codebase/SKILL.md @@ -0,0 +1,17 @@ +--- +name: gsd:map-codebase +description: Analyzes your entire codebase using parallel mapper agents and produces structured documents in .planning/codebase/. Covers tech stack, architecture, quality, and concerns. +--- + +## gsd:map-codebase +**Category:** GSD (Get Stuff Done) + +**What it does:** +Analyzes your entire codebase using parallel mapper agents and produces structured documents in `.planning/codebase/`. Covers tech stack, architecture, quality, and concerns. Gives Claude (and you) a comprehensive understanding of the project before major changes. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:map-codebase` From 81fc5257cbdf5715907b869b202b515184782ece Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:26 +0200 Subject: [PATCH 36/75] Add gsd-list-phase-assumptions skill --- gsd-list-phase-assumptions/SKILL.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 gsd-list-phase-assumptions/SKILL.md diff --git a/gsd-list-phase-assumptions/SKILL.md b/gsd-list-phase-assumptions/SKILL.md new file mode 100644 index 00000000..e56b524f --- /dev/null +++ b/gsd-list-phase-assumptions/SKILL.md @@ -0,0 +1,20 @@ +--- +name: gsd:list-phase-assumptions +description: Surfaces Claude's assumptions about how a phase will be approached before planning begins. Lets you catch and correct wrong assumptions early, before a bad plan is written. +--- + +## gsd:list-phase-assumptions +**Category:** GSD (Get Stuff Done) + +**What it does:** +Surfaces Claude's assumptions about how a phase will be approached before planning begins. Lets you catch and correct wrong assumptions early, before a bad plan is written. + +**When to trigger:** +Before planning a phase. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:list-phase-assumptions` From a37113d76ff54316992e82fd1eeb53db282e1da7 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:27 +0200 Subject: [PATCH 37/75] Add gsd-progress skill --- gsd-progress/SKILL.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 gsd-progress/SKILL.md diff --git a/gsd-progress/SKILL.md b/gsd-progress/SKILL.md new file mode 100644 index 00000000..6e804963 --- /dev/null +++ b/gsd-progress/SKILL.md @@ -0,0 +1,17 @@ +--- +name: gsd:progress +description: Checks overall project progress, shows current context (active milestone, phases, completion status), and routes you to the next action. Your project dashboard command. +--- + +## gsd:progress +**Category:** GSD (Get Stuff Done) + +**What it does:** +Checks overall project progress, shows current context (active milestone, phases, completion status), and routes you to the next action (execute or plan). Your project dashboard command. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:progress` From a7889f9bf8b222bb387cfb2974c367a0614a8d17 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:28 +0200 Subject: [PATCH 38/75] Add gsd-plan-phase skill --- gsd-plan-phase/SKILL.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 gsd-plan-phase/SKILL.md diff --git a/gsd-plan-phase/SKILL.md b/gsd-plan-phase/SKILL.md new file mode 100644 index 00000000..3b317f83 --- /dev/null +++ b/gsd-plan-phase/SKILL.md @@ -0,0 +1,20 @@ +--- +name: gsd:plan-phase +description: Creates a detailed phase plan (PLAN.md) with task breakdown, dependency analysis, and a verification loop. Runs research, planning, and plan-checker agents to ensure quality before execution. +--- + +## gsd:plan-phase +**Category:** GSD (Get Stuff Done) + +**What it does:** +Creates a detailed phase plan (`PLAN.md`) with a task breakdown, dependency analysis, and a verification loop. Runs a research agent, a planning agent, and a plan-checker agent to ensure quality before execution. + +**When to trigger:** +Before executing a phase. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:plan-phase` From 92f0d184fcc36cf6afa3954bc1e566b9a7d0f161 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:29 +0200 Subject: [PATCH 39/75] Add gsd-plan-milestone-gaps skill --- gsd-plan-milestone-gaps/SKILL.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 gsd-plan-milestone-gaps/SKILL.md diff --git a/gsd-plan-milestone-gaps/SKILL.md b/gsd-plan-milestone-gaps/SKILL.md new file mode 100644 index 00000000..950baede --- /dev/null +++ b/gsd-plan-milestone-gaps/SKILL.md @@ -0,0 +1,20 @@ +--- +name: gsd:plan-milestone-gaps +description: Creates phases to close all gaps identified by a milestone audit. After gsd:audit-milestone reveals missing work, this skill turns those gaps into actionable phases. +--- + +## gsd:plan-milestone-gaps +**Category:** GSD (Get Stuff Done) + +**What it does:** +Creates phases to close all gaps identified by a milestone audit. After running `gsd:audit-milestone` reveals missing work, this skill turns those gaps into actionable phases. + +**When to trigger:** +After `gsd:audit-milestone` finds gaps. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:plan-milestone-gaps` From 1b228c022a9be11fc81ba68bf929b8fb70ccfb4a Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:30 +0200 Subject: [PATCH 40/75] Add gsd-reapply-patches skill --- gsd-reapply-patches/SKILL.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 gsd-reapply-patches/SKILL.md diff --git a/gsd-reapply-patches/SKILL.md b/gsd-reapply-patches/SKILL.md new file mode 100644 index 00000000..e16593db --- /dev/null +++ b/gsd-reapply-patches/SKILL.md @@ -0,0 +1,20 @@ +--- +name: gsd:reapply-patches +description: Reapplies your local modifications after a GSD update. When you update GSD and your customizations are overwritten, this skill restores them. +--- + +## gsd:reapply-patches +**Category:** GSD (Get Stuff Done) + +**What it does:** +Reapplies your local modifications after a GSD update. When you update GSD and your customizations are overwritten, this skill restores them. + +**When to trigger:** +After running `gsd:update` and losing local customizations. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:reapply-patches` From 2a7f771f29ce71a253b2ed75510bbe3c61f298ae Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:30 +0200 Subject: [PATCH 41/75] Add gsd-quick skill --- gsd-quick/SKILL.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 gsd-quick/SKILL.md diff --git a/gsd-quick/SKILL.md b/gsd-quick/SKILL.md new file mode 100644 index 00000000..e3bb9463 --- /dev/null +++ b/gsd-quick/SKILL.md @@ -0,0 +1,17 @@ +--- +name: gsd:quick +description: Executes a quick task with GSD guarantees (atomic commits, state tracking) but skips optional agents. Faster than a full phase execution — best for small, well-defined tasks. +--- + +## gsd:quick +**Category:** GSD (Get Stuff Done) + +**What it does:** +Executes a quick task with GSD guarantees (atomic commits, state tracking) but skips optional agents like researchers and planners. Faster than a full phase execution — best for small, well-defined tasks. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:quick [task description]` From 1e50385c9d1d502aeba7608d283d3fd103600206 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:31 +0200 Subject: [PATCH 42/75] Add gsd-remove-phase skill --- gsd-remove-phase/SKILL.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 gsd-remove-phase/SKILL.md diff --git a/gsd-remove-phase/SKILL.md b/gsd-remove-phase/SKILL.md new file mode 100644 index 00000000..c3a2f378 --- /dev/null +++ b/gsd-remove-phase/SKILL.md @@ -0,0 +1,17 @@ +--- +name: gsd:remove-phase +description: Removes a future phase from the roadmap and automatically renumbers subsequent phases. Safe way to cancel planned work. +--- + +## gsd:remove-phase +**Category:** GSD (Get Stuff Done) + +**What it does:** +Removes a future phase from the roadmap and automatically renumbers subsequent phases. Safe way to cancel planned work. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:remove-phase` From 85b26376ae477b9d8f8c16fb72fc6e01397565e1 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:32 +0200 Subject: [PATCH 43/75] Add gsd-research-phase skill --- gsd-research-phase/SKILL.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 gsd-research-phase/SKILL.md diff --git a/gsd-research-phase/SKILL.md b/gsd-research-phase/SKILL.md new file mode 100644 index 00000000..c536f080 --- /dev/null +++ b/gsd-research-phase/SKILL.md @@ -0,0 +1,17 @@ +--- +name: gsd:research-phase +description: Researches how to implement a phase before planning. Standalone research step — normally runs automatically inside gsd:plan-phase, but can be invoked separately for deeper investigation. +--- + +## gsd:research-phase +**Category:** GSD (Get Stuff Done) + +**What it does:** +Researches how to implement a phase before planning. Standalone research step — normally this runs automatically inside `gsd:plan-phase`, but you can invoke it separately for deeper investigation. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:research-phase` From ac465f70a5c246ee8ac40f952d3929a8215f5131 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:33 +0200 Subject: [PATCH 44/75] Add gsd-verify-work skill --- gsd-verify-work/SKILL.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 gsd-verify-work/SKILL.md diff --git a/gsd-verify-work/SKILL.md b/gsd-verify-work/SKILL.md new file mode 100644 index 00000000..876f774e --- /dev/null +++ b/gsd-verify-work/SKILL.md @@ -0,0 +1,20 @@ +--- +name: gsd:verify-work +description: Validates built features through conversational UAT. Confirms that the phase goal was actually achieved, not just that tasks were completed. +--- + +## gsd:verify-work +**Category:** GSD (Get Stuff Done) + +**What it does:** +Validates built features through conversational UAT (User Acceptance Testing). Confirms that the phase goal was actually achieved, not just that tasks were completed. + +**When to trigger:** +After executing a phase. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:verify-work` From 6ffb53b7f71ee6564fc3802f0a5c1dd477aaf096 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:34 +0200 Subject: [PATCH 45/75] Add gsd-validate-phase skill --- gsd-validate-phase/SKILL.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 gsd-validate-phase/SKILL.md diff --git a/gsd-validate-phase/SKILL.md b/gsd-validate-phase/SKILL.md new file mode 100644 index 00000000..8af07195 --- /dev/null +++ b/gsd-validate-phase/SKILL.md @@ -0,0 +1,17 @@ +--- +name: gsd:validate-phase +description: Retroactively audits and fills Nyquist validation gaps for a completed phase. Generates missing tests and verifies coverage for phase requirements. +--- + +## gsd:validate-phase +**Category:** GSD (Get Stuff Done) + +**What it does:** +Retroactively audits and fills Nyquist validation gaps for a completed phase. Generates missing tests and verifies coverage for phase requirements. Use when a phase was completed but validation was skipped. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:validate-phase` From 7b25e39a41814f7a0b4db3234392b3ae4e97e8b1 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:34 +0200 Subject: [PATCH 46/75] Add gsd-update skill --- gsd-update/SKILL.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 gsd-update/SKILL.md diff --git a/gsd-update/SKILL.md b/gsd-update/SKILL.md new file mode 100644 index 00000000..0cb221f2 --- /dev/null +++ b/gsd-update/SKILL.md @@ -0,0 +1,17 @@ +--- +name: gsd:update +description: Updates GSD to the latest version and displays a changelog. Always run this on new machines or after a period away from GSD. +--- + +## gsd:update +**Category:** GSD (Get Stuff Done) + +**What it does:** +Updates GSD to the latest version and displays a changelog. Always run this on new machines or after a period away from GSD. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:update` From 841a724c697094042262689f7227fafcdf66a0ed Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:35 +0200 Subject: [PATCH 47/75] Add gsd-settings skill --- gsd-settings/SKILL.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 gsd-settings/SKILL.md diff --git a/gsd-settings/SKILL.md b/gsd-settings/SKILL.md new file mode 100644 index 00000000..2318b650 --- /dev/null +++ b/gsd-settings/SKILL.md @@ -0,0 +1,17 @@ +--- +name: gsd:settings +description: Configures GSD workflow toggles and model profile settings. Adjust how GSD behaves — which agents run, what's skipped, and which AI model profile to use. +--- + +## gsd:settings +**Category:** GSD (Get Stuff Done) + +**What it does:** +Configures GSD workflow toggles and model profile settings. Adjust how GSD behaves — which agents run, what's skipped, and which AI model profile to use. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:settings` From 7154895ab4e93d2e19fab3d4fdcf69c9b4b70fc5 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:36 +0200 Subject: [PATCH 48/75] Add gsd-set-profile skill --- gsd-set-profile/SKILL.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 gsd-set-profile/SKILL.md diff --git a/gsd-set-profile/SKILL.md b/gsd-set-profile/SKILL.md new file mode 100644 index 00000000..6dc2a520 --- /dev/null +++ b/gsd-set-profile/SKILL.md @@ -0,0 +1,20 @@ +--- +name: gsd:set-profile +description: Switches the model profile used by GSD agents. Three profiles available — quality (best models), balanced (default), budget (faster/cheaper). +--- + +## gsd:set-profile +**Category:** GSD (Get Stuff Done) + +**What it does:** +Switches the model profile used by GSD agents. Three profiles available: +- **quality** — uses the most capable models (slower, costlier) +- **balanced** — good default mix +- **budget** — faster and cheaper models + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:set-profile [quality|balanced|budget]` From a6c7b55b3c69164b3d91aa5aceec8ccc5308ebea Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:37 +0200 Subject: [PATCH 49/75] Add gsd-resume-work skill --- gsd-resume-work/SKILL.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 gsd-resume-work/SKILL.md diff --git a/gsd-resume-work/SKILL.md b/gsd-resume-work/SKILL.md new file mode 100644 index 00000000..167d7e2b --- /dev/null +++ b/gsd-resume-work/SKILL.md @@ -0,0 +1,20 @@ +--- +name: gsd:resume-work +description: Resumes work from a previous session with full context restoration. Reads the handoff document created by gsd:pause-work and gets Claude back up to speed instantly. +--- + +## gsd:resume-work +**Category:** GSD (Get Stuff Done) + +**What it does:** +Resumes work from a previous session with full context restoration. Reads the handoff document created by `gsd:pause-work` and gets Claude back up to speed instantly. + +**When to trigger:** +At the start of a new session when you paused work previously. + +**How to install GSD:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/gsd:resume-work` From 427b59dc67e621f8c937a8f563fd28539fc2542d Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:38 +0200 Subject: [PATCH 50/75] Add notion-create-task skill --- notion-create-task/SKILL.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 notion-create-task/SKILL.md diff --git a/notion-create-task/SKILL.md b/notion-create-task/SKILL.md new file mode 100644 index 00000000..fc417667 --- /dev/null +++ b/notion-create-task/SKILL.md @@ -0,0 +1,22 @@ +--- +name: Notion:create-task +description: Creates a new task in your Notion tasks database with sensible defaults. Quick way to log a task without leaving Claude Code. +--- + +## Notion:create-task +**Category:** Notion Integration + +**What it does:** +Creates a new task in your Notion tasks database with sensible defaults. Quick way to log a task without leaving Claude Code. + +**When to trigger:** +- "Add a task to Notion" +- "Create a Notion task for X" + +**How to install:** +```bash +npx claude install superpowers +``` +Also requires the **Notion MCP server** to be connected to Claude Code. + +**Trigger phrase:** Ask Claude to create a task in Notion. From 61dcaa3b66b952b3287cad31c63f26b930d3dd64 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:39 +0200 Subject: [PATCH 51/75] Add notion-create-database-row skill --- notion-create-database-row/SKILL.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 notion-create-database-row/SKILL.md diff --git a/notion-create-database-row/SKILL.md b/notion-create-database-row/SKILL.md new file mode 100644 index 00000000..6beb9551 --- /dev/null +++ b/notion-create-database-row/SKILL.md @@ -0,0 +1,21 @@ +--- +name: Notion:create-database-row +description: Inserts a new row into a specified Notion database using natural-language property values. You describe the row in plain English and Claude handles the property mapping. +--- + +## Notion:create-database-row +**Category:** Notion Integration + +**What it does:** +Inserts a new row into a specified Notion database using natural-language property values. You describe the row in plain English and Claude handles the property mapping. + +**When to trigger:** +- "Add a row to my [database name] in Notion" + +**How to install:** +```bash +npx claude install superpowers +``` +Also requires the **Notion MCP server** connected. + +**Trigger phrase:** Ask Claude to add a row or entry to a specific Notion database. From 227531d55bd331e3718c22dc54d34a035be138a3 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:39 +0200 Subject: [PATCH 52/75] Add notion-database-query skill --- notion-database-query/SKILL.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 notion-database-query/SKILL.md diff --git a/notion-database-query/SKILL.md b/notion-database-query/SKILL.md new file mode 100644 index 00000000..9e1dca00 --- /dev/null +++ b/notion-database-query/SKILL.md @@ -0,0 +1,22 @@ +--- +name: Notion:database-query +description: Queries a Notion database by name or ID and returns structured, readable results. Use to search or filter database content. +--- + +## Notion:database-query +**Category:** Notion Integration + +**What it does:** +Queries a Notion database by name or ID and returns structured, readable results. Use to search or filter database content. + +**When to trigger:** +- "Query my Notion [database name]" +- "Show me all tasks in Notion where status is X" + +**How to install:** +```bash +npx claude install superpowers +``` +Also requires the **Notion MCP server** connected. + +**Trigger phrase:** Ask Claude to query or search a Notion database. From a13e2bfa94f184c697110ceb3d920e6e31f1584d Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:40 +0200 Subject: [PATCH 53/75] Add notion-create-page skill --- notion-create-page/SKILL.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 notion-create-page/SKILL.md diff --git a/notion-create-page/SKILL.md b/notion-create-page/SKILL.md new file mode 100644 index 00000000..9d3141c0 --- /dev/null +++ b/notion-create-page/SKILL.md @@ -0,0 +1,22 @@ +--- +name: Notion:create-page +description: Creates a new Notion page, optionally under a specific parent, using the Notion Workspace Skill and Notion MCP server. +--- + +## Notion:create-page +**Category:** Notion Integration + +**What it does:** +Creates a new Notion page, optionally under a specific parent, using the Notion Workspace Skill and Notion MCP server. + +**When to trigger:** +- "Create a Notion page about X" +- "Make a new page under [parent]" + +**How to install:** +```bash +npx claude install superpowers +``` +Also requires the **Notion MCP server** connected. + +**Trigger phrase:** Ask Claude to create a Notion page. From 1212c8d48b44d24b51ba1b88141d9ed2f76073b4 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:41 +0200 Subject: [PATCH 54/75] Add notion-find skill --- notion-find/SKILL.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 notion-find/SKILL.md diff --git a/notion-find/SKILL.md b/notion-find/SKILL.md new file mode 100644 index 00000000..c0b38b83 --- /dev/null +++ b/notion-find/SKILL.md @@ -0,0 +1,22 @@ +--- +name: Notion:find +description: Quickly finds pages or databases in Notion by title keywords. Faster than full search for when you know roughly what you're looking for. +--- + +## Notion:find +**Category:** Notion Integration + +**What it does:** +Quickly finds pages or databases in Notion by title keywords. Faster than full search for when you know (roughly) what you're looking for. + +**When to trigger:** +- "Find the Notion page called X" +- "Look up [title] in Notion" + +**How to install:** +```bash +npx claude install superpowers +``` +Also requires the **Notion MCP server** connected. + +**Trigger phrase:** Ask Claude to find a specific Notion page by name. From b93b2b1d55a6fdb8403d61d4744eba1507a1cfff Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:42 +0200 Subject: [PATCH 55/75] Add notion-search skill --- notion-search/SKILL.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 notion-search/SKILL.md diff --git a/notion-search/SKILL.md b/notion-search/SKILL.md new file mode 100644 index 00000000..63bc93b3 --- /dev/null +++ b/notion-search/SKILL.md @@ -0,0 +1,22 @@ +--- +name: Notion:search +description: Searches your entire Notion workspace using the Notion MCP server. Performs semantic search across pages, databases, and connected sources. +--- + +## Notion:search +**Category:** Notion Integration + +**What it does:** +Searches your entire Notion workspace using the Notion MCP server. Performs semantic search across pages, databases, and connected sources. + +**When to trigger:** +- "Search Notion for X" +- "Find anything in Notion about X" + +**How to install:** +```bash +npx claude install superpowers +``` +Also requires the **Notion MCP server** connected. + +**Trigger phrase:** Ask Claude to search Notion for any topic. From 10652fa7a577cb403f914f8f731e0592b2ec08e4 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:43 +0200 Subject: [PATCH 56/75] Add notion-tasks-build skill --- notion-tasks-build/SKILL.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 notion-tasks-build/SKILL.md diff --git a/notion-tasks-build/SKILL.md b/notion-tasks-build/SKILL.md new file mode 100644 index 00000000..cc3f9362 --- /dev/null +++ b/notion-tasks-build/SKILL.md @@ -0,0 +1,21 @@ +--- +name: Notion:tasks:build +description: Builds a task from a Notion page URL. Reads the page content and structures it into an actionable task with the right properties. +--- + +## Notion:tasks:build +**Category:** Notion Integration — Tasks + +**What it does:** +Builds a task from a Notion page URL. Reads the page content and structures it into an actionable task with the right properties. + +**When to trigger:** +- "Build a task from this Notion page: [URL]" + +**How to install:** +```bash +npx claude install superpowers +``` +Also requires the **Notion MCP server** connected. + +**Trigger phrase:** Provide a Notion page URL and ask to build a task from it. From c56b204a9e0af2b6617a72b521be6a3ffc1a1ecb Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:43 +0200 Subject: [PATCH 57/75] Add notion-tasks-explain-diff skill --- notion-tasks-explain-diff/SKILL.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 notion-tasks-explain-diff/SKILL.md diff --git a/notion-tasks-explain-diff/SKILL.md b/notion-tasks-explain-diff/SKILL.md new file mode 100644 index 00000000..beccfe13 --- /dev/null +++ b/notion-tasks-explain-diff/SKILL.md @@ -0,0 +1,22 @@ +--- +name: Notion:tasks:explain-diff +description: Makes a Notion doc explaining a code change (diff). Useful for documenting what changed and why, directly in Notion. +--- + +## Notion:tasks:explain-diff +**Category:** Notion Integration — Tasks + +**What it does:** +Makes a Notion doc explaining a code change (diff). Useful for documenting what changed and why, directly in Notion. + +**When to trigger:** +- "Document this code change in Notion" +- "Explain this diff and save it to Notion" + +**How to install:** +```bash +npx claude install superpowers +``` +Also requires the **Notion MCP server** connected. + +**Trigger phrase:** Ask Claude to explain a code diff and create a Notion doc for it. From 386b5c1acc330aa1f4ae4b6297e085e66aec1bc2 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:44 +0200 Subject: [PATCH 58/75] Add notion-tasks-plan skill --- notion-tasks-plan/SKILL.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 notion-tasks-plan/SKILL.md diff --git a/notion-tasks-plan/SKILL.md b/notion-tasks-plan/SKILL.md new file mode 100644 index 00000000..0de7e7d6 --- /dev/null +++ b/notion-tasks-plan/SKILL.md @@ -0,0 +1,21 @@ +--- +name: Notion:tasks:plan +description: Plans a task from a Notion page URL. Reads the page and produces a structured implementation plan. +--- + +## Notion:tasks:plan +**Category:** Notion Integration — Tasks + +**What it does:** +Plans a task from a Notion page URL. Reads the page and produces a structured implementation plan. + +**When to trigger:** +- "Plan the task from this Notion page: [URL]" + +**How to install:** +```bash +npx claude install superpowers +``` +Also requires the **Notion MCP server** connected. + +**Trigger phrase:** Provide a Notion page URL and ask to plan the task. From acd658542b268dd8a9c0e02648a7e3019516f8ba Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:45 +0200 Subject: [PATCH 59/75] Add notion-tasks-setup skill --- notion-tasks-setup/SKILL.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 notion-tasks-setup/SKILL.md diff --git a/notion-tasks-setup/SKILL.md b/notion-tasks-setup/SKILL.md new file mode 100644 index 00000000..6f00f06a --- /dev/null +++ b/notion-tasks-setup/SKILL.md @@ -0,0 +1,22 @@ +--- +name: Notion:tasks:setup +description: Sets up a Notion task board for tracking tasks. Creates the database structure, views, and properties needed for a Claude Code + Notion workflow. +--- + +## Notion:tasks:setup +**Category:** Notion Integration — Tasks + +**What it does:** +Sets up a Notion task board for tracking tasks. Creates the database structure, views, and properties needed for a Claude Code + Notion workflow. + +**When to trigger:** +- "Set up a Notion task board for me" +- First-time Notion integration setup + +**How to install:** +```bash +npx claude install superpowers +``` +Also requires the **Notion MCP server** connected. + +**Trigger phrase:** Ask Claude to set up a Notion task board. From 891dd5ab5bdded57d393772ab44f1244b24ad9d7 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:46 +0200 Subject: [PATCH 60/75] Add figma-implement-design skill --- figma-implement-design/SKILL.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 figma-implement-design/SKILL.md diff --git a/figma-implement-design/SKILL.md b/figma-implement-design/SKILL.md new file mode 100644 index 00000000..65518a70 --- /dev/null +++ b/figma-implement-design/SKILL.md @@ -0,0 +1,25 @@ +--- +name: figma:implement-design +description: Translates Figma designs into production-ready code with 1:1 visual fidelity. Handles layout, spacing, colors, typography, and component structure. +--- + +## figma:implement-design +**Category:** Figma + +**What it does:** +Translates Figma designs into production-ready code with 1:1 visual fidelity. Handles layout, spacing, colors, typography, and component structure. + +**When to trigger:** +- Implementing UI from Figma files +- "Implement this design" +- "Generate code from this Figma" +- User provides a Figma URL +- "Build this component matching Figma specs" + +**How to install:** +```bash +npx claude install figma +``` +Also requires the **Figma MCP server** connected to Claude Code. + +**Trigger phrase:** Share a Figma URL and ask to implement or build the design. From 9482df3287ed0921ddecdfd1cba58b35594fa2f7 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:47 +0200 Subject: [PATCH 61/75] Add figma-code-connect-components skill --- figma-code-connect-components/SKILL.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 figma-code-connect-components/SKILL.md diff --git a/figma-code-connect-components/SKILL.md b/figma-code-connect-components/SKILL.md new file mode 100644 index 00000000..1ff4824f --- /dev/null +++ b/figma-code-connect-components/SKILL.md @@ -0,0 +1,24 @@ +--- +name: figma:code-connect-components +description: Connects Figma design components to code components using Code Connect. Creates mappings between Figma designs and code implementations so design tools show the real code. +--- + +## figma:code-connect-components +**Category:** Figma + +**What it does:** +Connects Figma design components to code components using Code Connect. Creates mappings between Figma designs and code implementations so design tools show the real code. + +**When to trigger:** +- "Code connect this component" +- "Connect Figma to code" +- "Map this component to code" +- "Create code connect mapping" + +**How to install:** +```bash +npx claude install figma +``` +Also requires the **Figma MCP server** connected. + +**Trigger phrase:** Ask to connect or map a Figma component to its code equivalent. From ad8231ff0d17ffadda10709e9ce34a10a30e2205 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:47 +0200 Subject: [PATCH 62/75] Add figma-create-design-system-rules skill --- figma-create-design-system-rules/SKILL.md | 24 +++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 figma-create-design-system-rules/SKILL.md diff --git a/figma-create-design-system-rules/SKILL.md b/figma-create-design-system-rules/SKILL.md new file mode 100644 index 00000000..729efc51 --- /dev/null +++ b/figma-create-design-system-rules/SKILL.md @@ -0,0 +1,24 @@ +--- +name: figma:create-design-system-rules +description: Generates custom design system rules for your codebase. Establishes project-specific conventions for Figma-to-code workflows — tokens, component naming, spacing scales, etc. +--- + +## figma:create-design-system-rules +**Category:** Figma + +**What it does:** +Generates custom design system rules for your codebase. Establishes project-specific conventions for Figma-to-code workflows — tokens, component naming, spacing scales, etc. + +**When to trigger:** +- "Create design system rules" +- "Generate rules for my project" +- "Set up design rules" +- "Customize design system guidelines" + +**How to install:** +```bash +npx claude install figma +``` +Also requires the **Figma MCP server** connected. + +**Trigger phrase:** Ask Claude to generate or set up design system rules for your project. From d5c5a1c62f5c2da24a105ca99deea7b82c8d5e7e Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:48 +0200 Subject: [PATCH 63/75] Add adspirer-keyword-research skill --- adspirer-keyword-research/SKILL.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 adspirer-keyword-research/SKILL.md diff --git a/adspirer-keyword-research/SKILL.md b/adspirer-keyword-research/SKILL.md new file mode 100644 index 00000000..e99aa6a2 --- /dev/null +++ b/adspirer-keyword-research/SKILL.md @@ -0,0 +1,21 @@ +--- +name: adspirer-ads-agent:keyword-research +description: Researches Google Ads keywords with real CPC data, search volumes, and competition analysis. Gives you data-driven keyword intelligence for ad campaigns. +--- + +## adspirer-ads-agent:keyword-research +**Category:** Adspirer Ads Agent + +**What it does:** +Researches Google Ads keywords with real CPC data, search volumes, and competition analysis. Gives you data-driven keyword intelligence for ad campaigns. + +**When to trigger:** +- Planning Google Ads campaigns +- Researching keywords with real cost and volume data + +**How to install:** +```bash +npx claude install adspirer-ads-agent +``` + +**Trigger phrase:** Ask Claude to research keywords for Google Ads, or invoke `/adspirer-ads-agent:keyword-research`. From e236c28e45db492ef00bf205c73d33e4b1581e0b Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:49 +0200 Subject: [PATCH 64/75] Add adspirer-ad-campaign-best-practices skill --- adspirer-ad-campaign-best-practices/SKILL.md | 22 ++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 adspirer-ad-campaign-best-practices/SKILL.md diff --git a/adspirer-ad-campaign-best-practices/SKILL.md b/adspirer-ad-campaign-best-practices/SKILL.md new file mode 100644 index 00000000..fca64baa --- /dev/null +++ b/adspirer-ad-campaign-best-practices/SKILL.md @@ -0,0 +1,22 @@ +--- +name: adspirer-ads-agent:ad-campaign-best-practices +description: Best practices for creating and managing ad campaigns across Google Ads, Meta Ads, LinkedIn Ads, and TikTok Ads. Covers planning, budgets, targeting, and optimization. +--- + +## adspirer-ads-agent:ad-campaign-best-practices +**Category:** Adspirer Ads Agent + +**What it does:** +Best practices for creating and managing ad campaigns across Google Ads, Meta Ads, LinkedIn Ads, and TikTok Ads. Covers planning campaigns, setting budgets, choosing targeting, and optimizing performance. + +**When to trigger:** +- Planning any paid ad campaign +- Setting budgets or targeting +- Optimizing campaign performance + +**How to install:** +```bash +npx claude install adspirer-ads-agent +``` + +**Trigger phrase:** Ask about ad campaign strategy, budgets, or targeting on any major ad platform. From 66f1219b41e090f8ea162746e2951ed4c96740d6 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:50 +0200 Subject: [PATCH 65/75] Add mintlify-mintlify skill --- mintlify-mintlify/SKILL.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 mintlify-mintlify/SKILL.md diff --git a/mintlify-mintlify/SKILL.md b/mintlify-mintlify/SKILL.md new file mode 100644 index 00000000..7d963075 --- /dev/null +++ b/mintlify-mintlify/SKILL.md @@ -0,0 +1,28 @@ +--- +name: mintlify:mintlify +description: Comprehensive reference for building Mintlify documentation sites. Covers creating pages, configuring docs.json, adding components, navigation, and API references. +--- + +## mintlify:mintlify +**Category:** Mintlify + +**What it does:** +Comprehensive reference for building Mintlify documentation sites. Routes to detailed reference files for all components and configuration options. Covers: +- Creating pages +- Configuring `docs.json` +- Adding components +- Setting up navigation +- Working with API references + +**When to trigger:** +- Working on a Mintlify docs site +- "How do I add X to Mintlify?" +- Configuring docs.json +- Building API reference pages + +**How to install:** +```bash +npx claude install mintlify +``` + +**Trigger phrase:** Any Mintlify documentation work — building pages, configuring navigation, adding components. From d80afcc3362ea4feba1f239dc30b6fe05254668e Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:51 +0200 Subject: [PATCH 66/75] Add instagram-prompt-extractor skill --- instagram-prompt-extractor/SKILL.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 instagram-prompt-extractor/SKILL.md diff --git a/instagram-prompt-extractor/SKILL.md b/instagram-prompt-extractor/SKILL.md new file mode 100644 index 00000000..9d4e0f01 --- /dev/null +++ b/instagram-prompt-extractor/SKILL.md @@ -0,0 +1,28 @@ +--- +name: instagram-prompt-extractor +description: Reverse-engineers AI generation prompts from any image or video. Works with URLs from Instagram, TikTok, Twitter/X, Pinterest, Reddit, Midjourney, DALL-E, and more — or local files. +--- + +## instagram-prompt-extractor +**Category:** Utility / Creative + +**What it does:** +Reverse-engineers AI generation prompts from any image or video. Works with URLs from Instagram, TikTok, Twitter/X, Pinterest, Reddit, Midjourney, DALL-E, Civitai, ArtStation, and direct image links — or local files. + +**Supported content:** Portraits, landscapes, architecture, fashion, food, abstract art, video clips — anything AI-generated. + +**When to trigger:** +- "What prompt made this?" +- "Extract the prompt from this image" +- "How was this generated?" +- "Reverse engineer this" +- "What AI made this?" +- "Recreate this style" +- User pastes any URL with an image/video and asks about AI generation + +**How to install:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** Share any image/video URL and ask how to recreate it or what AI prompt made it. From fc97bb5f96f37f6d62aef1bef9705d6e15fa5323 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:51 +0200 Subject: [PATCH 67/75] Add keybindings-help skill --- keybindings-help/SKILL.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 keybindings-help/SKILL.md diff --git a/keybindings-help/SKILL.md b/keybindings-help/SKILL.md new file mode 100644 index 00000000..139197f4 --- /dev/null +++ b/keybindings-help/SKILL.md @@ -0,0 +1,24 @@ +--- +name: keybindings-help +description: Helps you customize keyboard shortcuts in Claude Code. Rebind keys, add chord bindings, change the submit key, or modify ~/.claude/keybindings.json. +--- + +## keybindings-help +**Category:** Utility + +**What it does:** +Helps you customize keyboard shortcuts in Claude Code. You can rebind keys, add chord bindings (multi-key sequences), change the submit key, or modify `~/.claude/keybindings.json` directly. + +**When to trigger:** +- "Rebind Ctrl+S" +- "Add a chord shortcut" +- "Change the submit key" +- "Customize keybindings" + +**How to install:** +Bundled with Superpowers: +```bash +npx claude install superpowers +``` + +**Trigger phrase:** Ask Claude Code to customize, rebind, or modify keyboard shortcuts. From 8b4888e521326f623246881a3cecfb9691c9f904 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:52 +0200 Subject: [PATCH 68/75] Add simplify skill --- simplify/SKILL.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 simplify/SKILL.md diff --git a/simplify/SKILL.md b/simplify/SKILL.md new file mode 100644 index 00000000..6315d12d --- /dev/null +++ b/simplify/SKILL.md @@ -0,0 +1,22 @@ +--- +name: simplify +description: Reviews recently changed code for opportunities to reuse existing utilities, improve quality, and increase efficiency. Fixes issues found — a post-implementation polish pass. +--- + +## simplify +**Category:** Utility + +**What it does:** +Reviews recently changed code for opportunities to reuse existing utilities, improve quality, and increase efficiency. After reviewing, it fixes any issues found. Think of it as a post-implementation polish pass. + +**When to trigger:** +Invoke after writing or editing code: +- `/simplify` + +**How to install:** +Bundled with Superpowers: +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/simplify` — run after completing a feature or fix to clean up the implementation. From 2b79ac9898d9af7d30052ab0ce8225e741b41d89 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:53 +0200 Subject: [PATCH 69/75] Add loop skill --- loop/SKILL.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 loop/SKILL.md diff --git a/loop/SKILL.md b/loop/SKILL.md new file mode 100644 index 00000000..c5158dbc --- /dev/null +++ b/loop/SKILL.md @@ -0,0 +1,28 @@ +--- +name: loop +description: Runs a prompt or slash command on a recurring interval. Useful for polling, monitoring, or repeating a task automatically. +--- + +## loop +**Category:** Utility + +**What it does:** +Runs a prompt or slash command on a recurring interval. Useful for polling, monitoring, or repeating a task automatically. + +**Examples:** +- `/loop 5m /foo` — run `/foo` every 5 minutes +- Defaults to 10-minute interval if not specified + +**When to trigger:** +- Check a deploy every 5 minutes +- Keep running `/babysit-prs` repeatedly +- Poll for status on an interval + +**Do NOT use for one-off tasks** — only for recurring work. + +**How to install:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** `/loop [interval] [command]` From 8bdf68c624babd1654ff20df98ac188dc158f251 Mon Sep 17 00:00:00 2001 From: makladmk87-max Date: Mon, 16 Mar 2026 23:59:54 +0200 Subject: [PATCH 70/75] Add claude-api skill --- claude-api/SKILL.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 claude-api/SKILL.md diff --git a/claude-api/SKILL.md b/claude-api/SKILL.md new file mode 100644 index 00000000..e1620764 --- /dev/null +++ b/claude-api/SKILL.md @@ -0,0 +1,29 @@ +--- +name: claude-api +description: Guides building applications with the Claude API (Anthropic SDK) or Agent SDK. Covers API usage, tool use, streaming, and SDK patterns. Trigger when code imports anthropic or @anthropic-ai/sdk. +--- + +## claude-api +**Category:** Claude API / Anthropic SDK + +**What it does:** +Guides you in building applications with the Claude API (Anthropic SDK) or Agent SDK. Covers API usage, tool use, streaming, and SDK patterns. + +**When to trigger:** +- Your code imports `anthropic`, `@anthropic-ai/sdk`, or `claude_agent_sdk` +- You ask to use the Claude API or Anthropic SDK +- Building AI-powered apps with Claude as the backend + +**Do NOT trigger when:** code uses `openai` or other AI SDKs. + +**Latest model IDs:** +- Opus 4.6: `claude-opus-4-6` +- Sonnet 4.6: `claude-sonnet-4-6` +- Haiku 4.5: `claude-haiku-4-5-20251001` + +**How to install:** +```bash +npx claude install superpowers +``` + +**Trigger phrase:** Importing `anthropic` / asking to use the Claude or Anthropic API. From 4d35b3e3d19d53cac61035085d2cbf176a12c76b Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Mar 2026 20:56:59 +0000 Subject: [PATCH 71/75] Add instagram-fetch skill using yt-dlp Adds a new skill that fetches metadata, captions, and media from Instagram posts, reels, and stories via yt-dlp. Covers auth via browser cookies for private/gated content and explains sandbox network limitations. https://claude.ai/code/session_01As79wMkZAaM49e6Ldfxxot --- instagram-fetch/SKILL.md | 256 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 256 insertions(+) create mode 100644 instagram-fetch/SKILL.md diff --git a/instagram-fetch/SKILL.md b/instagram-fetch/SKILL.md new file mode 100644 index 00000000..ec4cec8f --- /dev/null +++ b/instagram-fetch/SKILL.md @@ -0,0 +1,256 @@ +--- +name: instagram-fetch +description: Fetch and analyze Instagram posts, reels, and stories. Use when a user shares an Instagram URL (post, reel, or story) and wants to extract content, captions, metadata, or download media. Uses yt-dlp for media download and metadata extraction. Requires yt-dlp and optionally Instagram credentials for private content. +--- + +# Instagram Fetch Skill + +Fetch metadata, captions, and media from Instagram posts, reels, and stories using yt-dlp. + +## When to Use This Skill + +Activate when the user shares an Instagram URL such as: +- `https://www.instagram.com/reel/...` +- `https://www.instagram.com/p/...` +- `https://www.instagram.com/stories/...` +- Any Instagram URL and asks to "fetch", "download", "analyze", or "summarize" it + +## Prerequisites + +### Install yt-dlp +```bash +pip install yt-dlp +# or +brew install yt-dlp +# or +sudo apt install yt-dlp +``` + +**Verify:** +```bash +yt-dlp --version +``` + +### (Optional) Instagram Login for Private Content +For private accounts or stories that require login: +```bash +# Login via browser cookies (recommended - no password needed) +yt-dlp --cookies-from-browser chrome "INSTAGRAM_URL" + +# Or using username/password +yt-dlp -u YOUR_USERNAME -p YOUR_PASSWORD "INSTAGRAM_URL" +``` + +## Core Workflows + +### Workflow 1: Fetch Reel/Post Metadata Only + +**When user shares a URL and wants caption/info without downloading:** + +```bash +yt-dlp --dump-json --no-download "INSTAGRAM_URL" 2>/dev/null +``` + +**Parse and report:** +1. `title` / `description` — caption text +2. `uploader` / `uploader_id` — account name +3. `timestamp` — post date +4. `like_count`, `comment_count`, `view_count` — engagement +5. `duration` — video length (reels) +6. `thumbnail` — cover image URL + +**Example response format:** +``` +Instagram Reel — @username + +Caption: "Check out this amazing sunset! 🌅 #travel #photography" + +Stats: +- Views: 1.2M +- Likes: 45,000 +- Comments: 892 +- Duration: 0:32 +- Posted: 2025-03-10 + +Direct URL: https://www.instagram.com/reel/ABC123/ +``` + +--- + +### Workflow 2: Download Reel/Post Video + +**When user wants to save the video:** + +```bash +# Download best quality to current directory +yt-dlp -o "%(uploader)s_%(id)s.%(ext)s" "INSTAGRAM_URL" + +# Download to specific output folder +yt-dlp -o "/mnt/user-data/outputs/%(uploader)s_%(id)s.%(ext)s" "INSTAGRAM_URL" + +# Download with cookies from browser (for private content) +yt-dlp --cookies-from-browser chrome -o "%(uploader)s_%(id)s.%(ext)s" "INSTAGRAM_URL" +``` + +**Report:** +``` +Downloaded: username_DVwYONVAVfj.mp4 +Size: 12.4 MB +Quality: 1080x1920 (1080p) +Saved to: /mnt/user-data/outputs/ +``` + +--- + +### Workflow 3: Extract Caption/Text Only + +**When user wants just the caption text:** + +```bash +yt-dlp --dump-json --no-download "INSTAGRAM_URL" 2>/dev/null | python3 -c " +import json, sys +data = json.load(sys.stdin) +print('Caption:', data.get('description', data.get('title', 'No caption found'))) +print('Posted by:', data.get('uploader', 'Unknown')) +print('Date:', data.get('upload_date', 'Unknown')) +" +``` + +--- + +### Workflow 4: Download Thumbnail/Cover Image + +**When user wants the cover image:** + +```bash +yt-dlp --write-thumbnail --skip-download -o "%(uploader)s_%(id)s" "INSTAGRAM_URL" +``` + +--- + +### Workflow 5: Batch Fetch Multiple URLs + +**When user provides multiple Instagram links:** + +```bash +# Save URLs to a file +cat > instagram_urls.txt << 'EOF' +https://www.instagram.com/reel/URL1/ +https://www.instagram.com/reel/URL2/ +https://www.instagram.com/p/URL3/ +EOF + +# Fetch metadata for all +yt-dlp --dump-json --no-download -a instagram_urls.txt 2>/dev/null +``` + +--- + +## Handling Common Issues + +### 403 Forbidden / Login Required + +Instagram often blocks unauthenticated requests. Solutions: + +```bash +# Option 1: Use browser cookies (best method) +yt-dlp --cookies-from-browser chrome "INSTAGRAM_URL" +yt-dlp --cookies-from-browser firefox "INSTAGRAM_URL" + +# Option 2: Export cookies manually and use cookie file +# In Chrome: use a cookies.txt extension, save to cookies.txt +yt-dlp --cookies cookies.txt "INSTAGRAM_URL" + +# Option 3: Username/password (less reliable due to 2FA) +yt-dlp -u your@email.com -p yourpassword "INSTAGRAM_URL" +``` + +### Rate Limiting + +```bash +# Add delays between requests +yt-dlp --sleep-interval 3 --max-sleep-interval 10 "INSTAGRAM_URL" +``` + +### Private Content + +```bash +# Must use cookies from a logged-in browser session +yt-dlp --cookies-from-browser chrome "INSTAGRAM_URL" +``` + +### CSRF Token Warning + +The warning `No csrf token set by Instagram API` is common and usually harmless. The download often still succeeds. + +--- + +## Output Parsing (Python Helper) + +When you get JSON from `--dump-json`, parse it like this: + +```python +import json, subprocess + +result = subprocess.run( + ["yt-dlp", "--dump-json", "--no-download", "INSTAGRAM_URL"], + capture_output=True, text=True +) + +if result.returncode == 0: + data = json.loads(result.stdout) + print(f"Title: {data.get('title', 'N/A')}") + print(f"Caption: {data.get('description', 'N/A')}") + print(f"Uploader: {data.get('uploader', 'N/A')} (@{data.get('uploader_id', 'N/A')})") + print(f"Views: {data.get('view_count', 'N/A'):,}") + print(f"Likes: {data.get('like_count', 'N/A'):,}") + print(f"Comments: {data.get('comment_count', 'N/A'):,}") + print(f"Duration: {data.get('duration', 0)}s") + print(f"Upload date: {data.get('upload_date', 'N/A')}") + print(f"Thumbnail: {data.get('thumbnail', 'N/A')}") +else: + print("Error:", result.stderr) +``` + +--- + +## Quick Reference + +```bash +# Metadata only (no download) +yt-dlp --dump-json --no-download "URL" + +# Download video +yt-dlp "URL" + +# Download with browser cookies +yt-dlp --cookies-from-browser chrome "URL" + +# Caption only +yt-dlp --dump-json --no-download "URL" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('description',''))" + +# Thumbnail only +yt-dlp --write-thumbnail --skip-download "URL" + +# Save to specific folder +yt-dlp -o "/path/to/folder/%(uploader)s_%(id)s.%(ext)s" "URL" +``` + +--- + +## Notes for Claude + +- Always try `--dump-json --no-download` first to avoid unnecessary downloads +- If 403 error occurs, suggest using `--cookies-from-browser chrome` or `firefox` +- Instagram blocks sandbox/server environments — this skill works best when run locally by the user +- For reels: key fields are `description` (caption), `uploader`, `view_count`, `like_count` +- The reel ID is in the URL: `instagram.com/reel/{REEL_ID}/` +- Always show the extracted caption prominently — that's usually what users want +- If network is blocked (proxy/sandbox), explain this clearly and provide the commands for the user to run locally + +--- + +**Version:** 1.0.0 +**Requires:** yt-dlp (`pip install yt-dlp`) +**Works with:** Instagram Reels, Posts (photos & carousels), IGTV +**Does NOT work with:** Instagram Stories (requires login + they expire) From 2458362b36f04d0ed1bffb2d81fc8e9814f93f6c Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Mar 2026 22:17:47 +0000 Subject: [PATCH 72/75] feat: add 25 new skills from Notion list Added all missing skills from the setup Notion page: Superpowers: brainstorming, planning, debugging, tdd, git-worktrees, code-review GSD workflow: gsd-new-project, gsd-plan-phase, gsd-execute-phase, gsd-debug, gsd-progress Notion integration: notion-find, notion-search, notion-create-page, notion-create-task, notion-database-query Figma: figma-implement-design, figma-design-system-rules, figma-code-connect Platform: adspirer (Google/Meta Ads), mintlify (docs sites) Utility: keybindings, simplify, loop, instagram-prompt-extractor https://claude.ai/code/session_01As79wMkZAaM49e6Ldfxxot --- adspirer/SKILL.md | 123 ++++++++++++++ brainstorming/SKILL.md | 68 ++++++++ code-review/SKILL.md | 121 +++++++++++++ debugging/SKILL.md | 117 +++++++++++++ figma-code-connect/SKILL.md | 169 ++++++++++++++++++ figma-design-system-rules/SKILL.md | 211 +++++++++++++++++++++++ figma-implement-design/SKILL.md | 128 +++++++++++--- git-worktrees/SKILL.md | 162 ++++++++++++++++++ gsd-debug/SKILL.md | 117 ++++++++++--- gsd-execute-phase/SKILL.md | 159 ++++++++++++++--- gsd-new-project/SKILL.md | 204 +++++++++++++++++++--- gsd-plan-phase/SKILL.md | 157 ++++++++++++++--- gsd-progress/SKILL.md | 122 +++++++++++-- instagram-prompt-extractor/SKILL.md | 175 ++++++++++++++++--- keybindings/SKILL.md | 113 +++++++++++++ loop/SKILL.md | 137 ++++++++++++--- mintlify/SKILL.md | 254 ++++++++++++++++++++++++++++ notion-create-page/SKILL.md | 135 ++++++++++++--- notion-create-task/SKILL.md | 129 +++++++++++--- notion-database-query/SKILL.md | 184 +++++++++++++++++--- notion-find/SKILL.md | 118 ++++++++++--- notion-search/SKILL.md | 146 +++++++++++++--- planning/SKILL.md | 93 ++++++++++ simplify/SKILL.md | 116 ++++++++++--- tdd/SKILL.md | 138 +++++++++++++++ 25 files changed, 3286 insertions(+), 310 deletions(-) create mode 100644 adspirer/SKILL.md create mode 100644 brainstorming/SKILL.md create mode 100644 code-review/SKILL.md create mode 100644 debugging/SKILL.md create mode 100644 figma-code-connect/SKILL.md create mode 100644 figma-design-system-rules/SKILL.md create mode 100644 git-worktrees/SKILL.md create mode 100644 keybindings/SKILL.md create mode 100644 mintlify/SKILL.md create mode 100644 planning/SKILL.md create mode 100644 tdd/SKILL.md diff --git a/adspirer/SKILL.md b/adspirer/SKILL.md new file mode 100644 index 00000000..e1f8ab53 --- /dev/null +++ b/adspirer/SKILL.md @@ -0,0 +1,123 @@ +--- +name: adspirer +description: Manage Google Ads and Meta (Facebook/Instagram) advertising campaigns — create, analyze, and optimize ads. Use this skill when the user wants to work with Google Ads or Meta Ads: creating campaigns, analyzing performance, writing ad copy, optimizing budgets, or troubleshooting ad issues. +--- + +# Adspirer — Google & Meta Ads Management + +Manage and optimize Google Ads and Meta Ads campaigns. + +## Capabilities + +- Analyze campaign performance and surface insights +- Write high-converting ad copy (headlines, descriptions, CTAs) +- Recommend targeting, bidding, and budget strategies +- Diagnose underperforming campaigns +- Build campaign structures for new products/promotions +- Interpret ad metrics and suggest optimizations + +## Key Metrics Reference + +### Google Ads +| Metric | Good benchmark | +|--------|---------------| +| CTR (Search) | > 3-5% | +| CTR (Display) | > 0.35% | +| Quality Score | 7-10 | +| Conversion Rate | Varies by industry; compare vs account average | +| ROAS | Depends on margins; typically target > 3x | +| CPA | Below target CPA set for campaign | + +### Meta Ads +| Metric | Good benchmark | +|--------|---------------| +| CTR (Link) | > 1% | +| CPM | Varies by audience/placement | +| Frequency | Keep < 3-4 for conversion campaigns | +| ROAS | Target varies; compare vs blended | +| Relevance Score / Quality Ranking | Above average | + +## Campaign Structure + +### Google Ads +``` +Account + └── Campaign (budget, bidding, location, device targets) + └── Ad Group (keyword/audience theme) + ├── Keywords (match types: broad, phrase, exact) + └── Ads (RSA, Performance Max, Display) +``` + +### Meta Ads +``` +Account + └── Campaign (objective: Awareness, Traffic, Conversions, etc.) + └── Ad Set (audience, budget, schedule, placement) + └── Ads (creative: image, video, carousel) +``` + +## Ad Copywriting + +### Google Search Ad (RSA) +- **Headlines**: Up to 15 headlines (30 chars each) — include keyword, benefit, CTA +- **Descriptions**: Up to 4 descriptions (90 chars each) — expand on benefits, USP +- **Best practices**: Pin headline 1 to brand/keyword, use all 15 headlines + +Example: +``` +Headline 1: [Keyword-based] "Buy Running Shoes Online" +Headline 2: [Benefit] "Free Shipping on Orders $50+" +Headline 3: [CTA] "Shop Top Brands Today" +Headline 4: [Social proof] "50,000+ Happy Customers" + +Description 1: "Discover our wide selection of running shoes from top brands. Find your perfect fit with free returns." +Description 2: "Shop Nike, Adidas, Brooks & more. Fast shipping available. Order by 3pm for same-day dispatch." +``` + +### Meta Ad +- **Primary text**: 125 chars visible before "See more" (key message first) +- **Headline**: 40 chars — punchy benefit or offer +- **Description**: 30 chars — supporting detail +- **CTA button**: Match to action (Shop Now, Learn More, Sign Up, etc.) + +## Audience Targeting + +### Google Ads +- **Search**: Keywords define audience intent — use negative keywords to exclude irrelevant traffic +- **Performance Max**: Asset-based; uses Google's signals +- **Audiences**: Remarketing, Customer Match, Similar Audiences, In-Market, Affinity + +### Meta Ads +- **Core audiences**: Demographics, interests, behaviors +- **Custom audiences**: Website visitors (pixel), email lists, app users, video views +- **Lookalike audiences**: 1-10% lookalike from Custom Audience source +- **Best practice**: Start with 3-5% lookalike from buyers; narrow with interest stacking + +## Optimization Workflow + +When asked to optimize a campaign: + +1. **Audit performance** — identify top/bottom performers at campaign, ad set, and ad level +2. **Budget allocation** — shift budget toward top performers +3. **Bid adjustments** — device, location, time-of-day adjustments +4. **Pause underperformers** — cut ad sets/ads below CPA threshold (after sufficient data) +5. **Test new creative** — if CTR low, test new headlines/images +6. **Audience refinement** — narrow or expand based on performance data +7. **Negative keywords** (Google) — review Search Terms report weekly + +## Troubleshooting Common Issues + +| Issue | Likely Cause | Fix | +|-------|-------------|-----| +| High CPC, low CTR | Low Quality Score / irrelevant audience | Improve ad relevance to keywords; tighten targeting | +| Good CTR, low conversions | Landing page issue | A/B test landing page; check tracking | +| Ads not delivering | Low budget, disapproved ads, narrow audience | Increase budget; fix policy issues; broaden audience | +| ROAS declining | Audience fatigue / increased competition | Refresh creative; test new audiences | +| Meta ads approved but no delivery | Audience too small, bid too low | Broaden audience; use Advantage+ placements | + +## Notes for Claude + +- Always ask for the user's goal before recommending (awareness vs leads vs sales vs ROAS) +- Ask for current metrics before optimization — don't recommend without data +- Budgets, bids, and targeting should be treated as hypotheses to test, not permanent decisions +- Follow platform policies — flag any creative that risks disapproval (misleading claims, restricted categories) diff --git a/brainstorming/SKILL.md b/brainstorming/SKILL.md new file mode 100644 index 00000000..c1ffc216 --- /dev/null +++ b/brainstorming/SKILL.md @@ -0,0 +1,68 @@ +--- +name: brainstorming +description: Facilitate creative brainstorming sessions to generate ideas, explore possibilities, and unlock novel solutions. Use this skill when the user wants to generate ideas, explore options, think through a problem from multiple angles, or needs creative inspiration. +--- + +# Brainstorming + +Facilitate high-quality brainstorming sessions that generate novel, diverse, and actionable ideas. + +## Core Approach + +Brainstorming works best when judgment is suspended during idea generation. Generate quantity first, then evaluate quality. Encourage divergent thinking before converging on solutions. + +## Brainstorming Modes + +### Mode 1: Open Exploration +When the user has a vague prompt or wants to explore broadly: +1. Reframe the problem in 2-3 different ways to unlock new angles +2. Generate ideas across different categories: conventional, unconventional, contrarian, and wild +3. Aim for at least 10-15 distinct ideas before filtering +4. Present ideas in clusters/themes, not just a flat list + +### Mode 2: Constrained Generation +When the user has specific constraints (time, budget, tech, audience): +1. Acknowledge constraints explicitly upfront +2. Generate ideas that respect hard constraints +3. Flag which ideas push soft constraints — sometimes constraints are negotiable +4. Include at least one idea that challenges a stated constraint + +### Mode 3: Build on Existing Ideas +When the user has partial ideas and wants to expand: +1. Extract the core insight from each existing idea +2. Generate variations: bigger, smaller, inverted, combined, applied elsewhere +3. Apply SCAMPER: Substitute, Combine, Adapt, Modify, Put to other uses, Eliminate, Reverse + +## Framing Techniques + +Use these to unlock stuck thinking: + +- **Analogy**: "How would [unrelated industry/person] solve this?" +- **First principles**: "What's the most fundamental version of this problem?" +- **Inversion**: "What would make this maximally worse? Now invert." +- **Time travel**: "What would a solution from 10 years ago / 10 years future look like?" +- **Scale extremes**: "What if this needed to work for 1 person? 1 billion people?" +- **Resource extremes**: "What if budget were zero? Unlimited?" + +## Output Format + +Structure brainstorming output as: +1. **Reframed problem** (1-2 sentences) — confirm the real problem being solved +2. **Idea clusters** — group related ideas under themes +3. **Wild card** — one deliberately unconventional or counterintuitive idea +4. **Top 3 picks** — brief rationale for the most promising ideas +5. **Next step** — a concrete action to move from ideas to execution + +## Facilitating Multi-Round Sessions + +If the user wants to iterate: +- Ask "Which of these resonates most? Why?" to identify promising directions +- Drill deeper into selected ideas: risks, variations, prerequisites +- Combine ideas from different clusters +- Narrow to 1-3 actionable concepts with clear next steps + +## Notes + +- Never dismiss an idea during generation — defer evaluation to later +- If the user seems stuck on one approach, introduce deliberate constraints to force new thinking +- Brainstorming sessions should end with clarity, not just more options diff --git a/code-review/SKILL.md b/code-review/SKILL.md new file mode 100644 index 00000000..7b7aaf22 --- /dev/null +++ b/code-review/SKILL.md @@ -0,0 +1,121 @@ +--- +name: code-review +description: Perform thorough, constructive code reviews covering correctness, security, performance, maintainability, and style. Use this skill when the user wants code reviewed, asks for feedback on their code, or needs a diff/PR reviewed. +--- + +# Code Review + +Perform thorough, actionable code reviews that improve code quality, catch bugs, and share knowledge. + +## Review Dimensions + +Review code across these dimensions, in order of importance: + +### 1. Correctness +Does the code do what it's supposed to do? +- Does it handle edge cases? (empty input, null/undefined, zero, large values) +- Are there off-by-one errors in loops or indices? +- Is the logic correct for all branches? +- Does error handling cover all failure paths? +- Are async operations handled correctly? (race conditions, unresolved promises) +- Are there any infinite loops or missing loop termination conditions? + +### 2. Security +Does the code introduce security vulnerabilities? +- **Injection** — SQL injection, XSS, command injection, template injection +- **Authentication/Authorization** — are permissions checked? Can users access others' data? +- **Input validation** — is user input sanitized/validated before use? +- **Secrets** — are credentials, tokens, or keys hardcoded or leaked in logs? +- **Sensitive data** — is PII/sensitive data logged, exposed in errors, or stored insecurely? +- **Dependencies** — are new dependencies vetted for known vulnerabilities? + +### 3. Performance +Does the code perform well at scale? +- **N+1 queries** — database queries inside loops +- **Unnecessary computation** — repeated calculations that could be cached +- **Memory leaks** — unreleased resources, growing collections +- **Blocking operations** — sync I/O in async contexts +- **Inefficient data structures** — O(n) lookups where O(1) is possible + +### 4. Maintainability +Will this code be easy to understand and change? +- Is the code readable? Would another developer understand it quickly? +- Are variable/function names descriptive and accurate? +- Is there duplication that should be extracted? +- Are functions/methods doing too much? (single responsibility) +- Is complexity appropriate? (avoid over-engineering) +- Are there magic numbers or strings that should be named constants? + +### 5. Tests +Is the change adequately tested? +- Are new features covered by tests? +- Are edge cases and error paths tested? +- Are tests meaningful? (not just asserting implementation details) +- Does test coverage actually test the behavior that matters? + +### 6. Style and Conventions +Does the code follow team/project conventions? +- Naming conventions (camelCase, snake_case, etc.) +- File and module organization +- Comment style and quality +- Import ordering + +## Review Output Format + +Structure reviews as: + +``` +## Summary +[1-3 sentence overview of the change and overall assessment] + +## Critical Issues (must fix) +- [issue]: [explanation] [line reference if applicable] + Suggestion: [how to fix] + +## Minor Issues (should fix) +- [issue]: [explanation] + Suggestion: [how to fix] + +## Nits (optional) +- [style/preference items] + +## Positives +- [things done well — always include at least one] +``` + +## Tone and Approach + +- **Be specific** — "this could be cleaner" is not useful; explain what and why +- **Explain the why** — don't just flag issues, explain why they matter +- **Suggest, don't dictate** — for style/preference: "consider X" not "do X" +- **Acknowledge good work** — point out what's done well, not just problems +- **Prioritize** — distinguish blocking issues from minor suggestions + +## Review Checklist + +Before submitting the review, verify: +- [ ] Correctness checked for all code paths +- [ ] Security vulnerabilities checked (injection, auth, input validation, secrets) +- [ ] Performance issues checked (N+1, unnecessary computation) +- [ ] Tests are present and meaningful +- [ ] Variable/function names are clear +- [ ] No debug code, console.logs, or TODOs left in +- [ ] Breaking changes identified +- [ ] Documentation updated if needed + +## Common Issues Quick Reference + +| Category | Pattern to Flag | +|----------|----------------| +| Security | `eval()`, string concatenation in SQL, `innerHTML =`, hardcoded credentials | +| Performance | Query inside loop, `.find()` in inner loop, sync file I/O | +| Correctness | Missing null check, uncaught promise, off-by-one in slice | +| Maintainability | Function >50 lines, nesting >3 levels, magic number | +| Tests | No error path test, mock returning wrong shape | + +## Notes for Claude + +- Read the full diff before commenting — context from other changes matters +- Check if tests were updated to cover the change +- Flag security issues as Critical regardless of other context +- If reviewing a PR, understand the PR description and intended goal first diff --git a/debugging/SKILL.md b/debugging/SKILL.md new file mode 100644 index 00000000..7a67d297 --- /dev/null +++ b/debugging/SKILL.md @@ -0,0 +1,117 @@ +--- +name: debugging +description: Systematically diagnose and fix bugs, errors, and unexpected behavior in code. Use this skill when the user has a bug, error message, unexpected behavior, or broken code that needs investigation and resolution. +--- + +# Debugging + +Systematically diagnose and resolve bugs using structured investigation rather than random trial and error. + +## Debugging Philosophy + +Debugging is hypothesis-driven. Each step should: +1. Form a hypothesis about the root cause +2. Design a minimal test to confirm or refute it +3. Act on the result — fix or form the next hypothesis + +Avoid random changes. Each change should test a specific hypothesis. + +## Step 1: Understand the Bug + +Before touching code, gather complete information: + +- **What is the expected behavior?** +- **What is the actual behavior?** +- **When does it happen?** Always? Under specific conditions? +- **When did it start?** After a recent change? Always present? +- **What's the error?** Exact error message, stack trace, log output +- **What's the environment?** OS, runtime version, dependencies, config + +Ask the user for any missing context before guessing. + +## Step 2: Reproduce the Bug + +Always reproduce before fixing: +- Find the minimal reproduction case +- Confirm the bug is reproducible consistently +- Rule out environment-specific issues (works on my machine?) +- If flaky: identify the conditions that trigger it + +## Step 3: Locate the Source + +Narrow down where the bug lives: + +**Read the error message carefully:** +- Stack traces point to the line — but the bug may be higher up the call stack +- Error types (TypeError, KeyError, etc.) hint at the category of problem + +**Bisect the problem:** +- Comment out / disable sections to isolate the faulty component +- Use binary search on recent commits if regression: `git bisect` +- Add logging/print statements to trace execution flow + +**Check common culprits first:** +- Off-by-one errors in loops/indices +- Null/undefined/None not handled +- Type mismatches (string vs int, etc.) +- Async/timing issues (race conditions, unresolved promises) +- Scope issues (variable shadowing, closures) +- Mutation of shared state +- Wrong assumptions about external data shape + +## Step 4: Fix and Verify + +Once the root cause is identified: +1. Write the fix — targeted and minimal; avoid refactoring while debugging +2. Verify the original bug is gone with the reproduction case +3. Check for regressions — does anything else break? +4. Consider edge cases: what related inputs might also fail? + +## Step 5: Document + +After fixing: +- Add a comment explaining WHY the fix works (not just what it does) +- Add a test that would have caught this bug +- Note if there are related areas that might have the same issue + +## Debugging Tools by Context + +**JavaScript/TypeScript:** +```js +console.log(), console.error(), console.trace() +debugger; // pause in browser/Node +// Chrome DevTools, VS Code debugger +``` + +**Python:** +```python +print(), logging.debug() +import pdb; pdb.set_trace() # or breakpoint() in Python 3.7+ +# VS Code debugger, pdb, ipdb +``` + +**Git bisect (for regressions):** +```bash +git bisect start +git bisect bad HEAD +git bisect good +# Run tests, mark good/bad, git will find the culprit commit +``` + +## Common Bug Patterns + +| Symptom | Likely Cause | +|---------|-------------| +| Works sometimes, fails sometimes | Race condition, async issue, flaky dependency | +| Only fails on specific input | Edge case, boundary condition | +| Fails only in production | Environment difference, missing config, different data | +| Was working, now broken | Recent change introduced regression | +| Wrong output, no error | Logic error, wrong algorithm, off-by-one | +| Correct output but crash later | Side effect, state mutation | + +## Notes for Claude + +- Read the full stack trace — the error origin is often not where the exception is thrown +- If the user has tried things already, ask what they tried — avoid repeating dead ends +- Never guess and apply multiple changes at once — test one hypothesis at a time +- If unable to reproduce locally, ask the user to add logging/print statements and share output diff --git a/figma-code-connect/SKILL.md b/figma-code-connect/SKILL.md new file mode 100644 index 00000000..cceb0d54 --- /dev/null +++ b/figma-code-connect/SKILL.md @@ -0,0 +1,169 @@ +--- +name: figma-code-connect +description: Set up and manage Figma Code Connect — link Figma components to real code components so devs see actual code snippets in Figma Dev Mode. Use this skill when the user wants to connect their Figma design system to their React/other framework component library using Figma's Code Connect feature. +--- + +# Figma: Code Connect + +Link Figma components to real code components using Figma Code Connect. + +## What is Code Connect? + +Figma Code Connect maps Figma design components to their code implementations. When developers inspect a component in Figma Dev Mode, they see real code snippets from the actual codebase instead of generated CSS. + +## Prerequisites + +- Figma account with Dev Mode access +- Node.js project with a component library +- Figma personal access token + +## Installation + +```bash +npm install --save-dev @figma/code-connect +# or +npx figma connect +``` + +## Setup + +### 1. Authenticate + +```bash +npx figma connect login +# Enter your Figma personal access token when prompted +# Token: https://www.figma.com/settings → Personal access tokens +``` + +Or set via environment variable: +```bash +export FIGMA_ACCESS_TOKEN=figd_... +``` + +### 2. Initialize + +```bash +npx figma connect create +``` + +This creates a `figma.config.json`: +```json +{ + "codeConnect": { + "include": ["src/**/*.figma.tsx"], + "exclude": ["node_modules/**"] + } +} +``` + +## Creating Code Connect Files + +For each Figma component, create a `.figma.tsx` (or `.figma.ts`) file: + +### Basic Example — Button + +```tsx +// src/components/Button/Button.figma.tsx +import figma from '@figma/code-connect' +import { Button } from './Button' + +figma.connect(Button, 'https://www.figma.com/design/FILE_ID/DESIGN_NAME?node-id=COMPONENT_NODE_ID', { + props: { + variant: figma.enum('Variant', { + Default: 'default', + Primary: 'primary', + Destructive: 'destructive', + }), + size: figma.enum('Size', { + Small: 'sm', + Medium: 'md', + Large: 'lg', + }), + disabled: figma.boolean('Disabled'), + label: figma.string('Label'), + }, + example: ({ variant, size, disabled, label }) => ( + + ), +}) +``` + +### Input Component Example + +```tsx +import figma from '@figma/code-connect' +import { Input } from './Input' + +figma.connect(Input, 'FIGMA_URL?node-id=NODE_ID', { + props: { + placeholder: figma.string('Placeholder'), + disabled: figma.boolean('Disabled'), + error: figma.boolean('Error'), + }, + example: ({ placeholder, disabled, error }) => ( + + ), +}) +``` + +## Figma URL Format + +Get the component URL from Figma: +1. Open Figma file +2. Right-click the component in the canvas +3. "Copy link to selection" +4. URL format: `https://www.figma.com/design/FILE_ID/NAME?node-id=X-Y` + +## Publishing Code Connect + +```bash +# Preview what will be published +npx figma connect publish --dry-run + +# Publish to Figma +npx figma connect publish +``` + +## Prop Mappers Reference + +| Figma Prop Type | Code Connect Mapper | +|----------------|---------------------| +| Enum/Variant | `figma.enum('Prop Name', { FigmaOption: 'codeValue' })` | +| Boolean | `figma.boolean('Prop Name')` | +| String | `figma.string('Prop Name')` | +| Number | `figma.number('Prop Name')` | +| Instance swap | `figma.instance('Prop Name')` | +| Nested instance | `figma.nestedProps('Layer Name', { ... })` | + +## CI Integration + +Add to CI pipeline to keep Code Connect up to date: +```yaml +# .github/workflows/figma-code-connect.yml +- name: Publish Code Connect + run: npx figma connect publish + env: + FIGMA_ACCESS_TOKEN: ${{ secrets.FIGMA_ACCESS_TOKEN }} +``` + +## Process for Connecting a Component Library + +1. Get component node IDs from Figma (right-click → copy link) +2. Create `.figma.tsx` file for each component +3. Map Figma property names to code prop names +4. Write the `example` render function +5. Run `npx figma connect publish --dry-run` to verify +6. Run `npx figma connect publish` to push live + +## Notes + +- Component node IDs change if components are moved between files +- Keep `.figma.tsx` files co-located with their components +- Test locally with `--dry-run` before publishing +- Figma Dev Mode must be enabled on the file to see Code Connect snippets diff --git a/figma-design-system-rules/SKILL.md b/figma-design-system-rules/SKILL.md new file mode 100644 index 00000000..58b40308 --- /dev/null +++ b/figma-design-system-rules/SKILL.md @@ -0,0 +1,211 @@ +--- +name: figma-design-system-rules +description: Extract, document, and enforce design system rules from a Figma design system. Use this skill when the user wants to document their design system, create design tokens, establish component usage rules, or ensure code follows a Figma design system. +--- + +# Figma: Design System Rules + +Extract and document design system rules from Figma for use in code implementation. + +## When to Use + +Use when the user: +- Wants to document their Figma design system for developers +- Needs to create a design tokens file from Figma specs +- Wants rules for how components should be used +- Is setting up a new codebase to match an existing Figma design system + +## Design System Components to Document + +### 1. Color Tokens + +Extract all color styles from Figma: + +```ts +// design-tokens/colors.ts +export const colors = { + // Brand + primary: { + 50: '#EFF6FF', + 100: '#DBEAFE', + 500: '#3B82F6', + 600: '#2563EB', + 700: '#1D4ED8', + }, + // Semantic + text: { + primary: '#111827', + secondary: '#6B7280', + disabled: '#D1D5DB', + }, + background: { + default: '#FFFFFF', + subtle: '#F9FAFB', + muted: '#F3F4F6', + }, + status: { + success: '#10B981', + warning: '#F59E0B', + error: '#EF4444', + info: '#3B82F6', + }, +} as const; +``` + +### 2. Typography Tokens + +```ts +export const typography = { + fonts: { + heading: '"Inter", system-ui, sans-serif', + body: '"Inter", system-ui, sans-serif', + mono: '"JetBrains Mono", monospace', + }, + sizes: { + xs: '0.75rem', // 12px + sm: '0.875rem', // 14px + base: '1rem', // 16px + lg: '1.125rem', // 18px + xl: '1.25rem', // 20px + '2xl': '1.5rem', // 24px + '3xl': '1.875rem',// 30px + '4xl': '2.25rem', // 36px + }, + weights: { + normal: 400, + medium: 500, + semibold: 600, + bold: 700, + }, + lineHeights: { + tight: 1.25, + normal: 1.5, + relaxed: 1.75, + }, +} as const; +``` + +### 3. Spacing Scale + +```ts +export const spacing = { + 0: '0', + 1: '4px', + 2: '8px', + 3: '12px', + 4: '16px', + 5: '20px', + 6: '24px', + 8: '32px', + 10: '40px', + 12: '48px', + 16: '64px', + 20: '80px', + 24: '96px', +} as const; +``` + +### 4. Border Radius + +```ts +export const radius = { + none: '0', + sm: '4px', + md: '8px', + lg: '12px', + xl: '16px', + '2xl': '24px', + full: '9999px', +} as const; +``` + +### 5. Shadows + +```ts +export const shadows = { + sm: '0 1px 2px 0 rgba(0, 0, 0, 0.05)', + md: '0 4px 6px -1px rgba(0, 0, 0, 0.1)', + lg: '0 10px 15px -3px rgba(0, 0, 0, 0.1)', + xl: '0 20px 25px -5px rgba(0, 0, 0, 0.1)', +} as const; +``` + +### 6. Breakpoints + +```ts +export const breakpoints = { + sm: '640px', + md: '768px', + lg: '1024px', + xl: '1280px', + '2xl': '1536px', +} as const; +``` + +## Component Usage Rules + +For each component in the design system, document: + +### Component Rule Template +```md +## [ComponentName] + +**Usage:** When to use this component +**Don't use when:** When NOT to use this component + +### Variants +- `default` — Standard usage +- `primary` — Main CTA +- `destructive` — Dangerous actions + +### Sizes +- `sm` — Compact layouts +- `md` — Default +- `lg` — Hero sections + +### States +- `default`, `hover`, `focus`, `disabled`, `loading` + +### Dos and Don'ts +✅ Do: [correct usage] +❌ Don't: [incorrect usage] +``` + +## CSS Custom Properties Export + +For use in CSS/Tailwind projects: +```css +:root { + /* Colors */ + --color-primary: #2563EB; + --color-primary-light: #DBEAFE; + --color-text: #111827; + --color-text-muted: #6B7280; + --color-bg: #FFFFFF; + --color-bg-subtle: #F9FAFB; + + /* Typography */ + --font-sans: 'Inter', system-ui, sans-serif; + --text-sm: 0.875rem; + --text-base: 1rem; + --text-lg: 1.125rem; + + /* Spacing */ + --space-4: 1rem; + --space-8: 2rem; + + /* Radius */ + --radius-md: 0.5rem; + --radius-lg: 0.75rem; + + /* Shadows */ + --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1); +} +``` + +## Notes + +- Ask the user to share Figma design system pages, color styles, and text styles +- Create tokens as a single source of truth — import everywhere +- Document rules that are NOT obvious from the tokens (e.g., "never use red for non-error states") +- For Tailwind projects, translate tokens into `tailwind.config.js` theme extensions diff --git a/figma-implement-design/SKILL.md b/figma-implement-design/SKILL.md index 65518a70..ec4ac544 100644 --- a/figma-implement-design/SKILL.md +++ b/figma-implement-design/SKILL.md @@ -1,25 +1,103 @@ ---- -name: figma:implement-design -description: Translates Figma designs into production-ready code with 1:1 visual fidelity. Handles layout, spacing, colors, typography, and component structure. ---- - -## figma:implement-design -**Category:** Figma - -**What it does:** -Translates Figma designs into production-ready code with 1:1 visual fidelity. Handles layout, spacing, colors, typography, and component structure. - -**When to trigger:** -- Implementing UI from Figma files -- "Implement this design" -- "Generate code from this Figma" -- User provides a Figma URL -- "Build this component matching Figma specs" - -**How to install:** -```bash -npx claude install figma -``` -Also requires the **Figma MCP server** connected to Claude Code. - -**Trigger phrase:** Share a Figma URL and ask to implement or build the design. +--- +name: figma-implement-design +description: Implement a Figma design as production-ready frontend code. Use this skill when the user shares a Figma design link or screenshot and wants it converted to HTML/CSS, React, or another frontend framework. +--- + +# Figma: Implement Design + +Convert a Figma design into production-ready frontend code. + +## When to Use + +Use when the user: +- Shares a Figma link or screenshot and asks to "implement this" +- Says "build this design" / "code this mockup" +- Wants to convert a visual design to working code + +## Process + +### Step 1: Gather Design Information + +The user must provide one of: +- **Figma URL**: `https://www.figma.com/design/...` or `https://www.figma.com/file/...` +- **Screenshot/image**: Visual of the design to implement +- **Figma Dev Mode export**: CSS properties, component specs + +If only a URL is provided and no Figma MCP is configured, ask the user to: +1. Open Figma Dev Mode (Shift+D or bottom bar → Dev) +2. Share relevant CSS properties, spacing values, colors, and font specs +3. Export relevant assets (icons, images) + +### Step 2: Extract Design Tokens + +Before coding, identify and document: +- **Colors**: Background, text, border, accent colors (as hex/rgb) +- **Typography**: Font family, sizes, weights, line heights +- **Spacing**: Padding, margin, gap values +- **Border radius**: Corner radius values +- **Shadows**: Box shadow values +- **Breakpoints**: Responsive design specs if provided + +Example CSS variables to set up: +```css +:root { + --color-primary: #2563EB; + --color-text: #1F2937; + --color-bg: #F9FAFB; + --font-heading: 'Inter', sans-serif; + --radius-md: 8px; + --spacing-md: 16px; +} +``` + +### Step 3: Identify Components + +Break the design into reusable components: +- Identify repeated UI patterns +- Define component hierarchy (what contains what) +- Note interactive states: hover, active, focus, disabled + +### Step 4: Implement + +Implement using the stack the user specifies. Defaults: +- **No preference**: HTML + CSS (no framework) +- **React asked**: React with CSS modules or Tailwind +- **Vue asked**: Vue 3 SFCs +- **Tailwind available**: Use Tailwind utility classes + +**Implementation priorities:** +1. Layout (flexbox/grid structure matches design) +2. Typography (font, size, weight, color) +3. Colors and backgrounds +4. Spacing (padding, margin, gaps) +5. Border radius and shadows +6. Hover/interactive states +7. Responsive behavior + +### Step 5: Asset Handling + +For images and icons: +- Use placeholder images if real assets aren't provided: `https://placehold.co/400x300` +- For icons: use Lucide React, Heroicons, or inline SVG +- Note which assets need to be replaced with real ones + +## Code Quality Standards + +- Semantic HTML (`
`, `