From a63f54b8abb9975cd11c296ff0503a681520a76d Mon Sep 17 00:00:00 2001 From: Federico Bartoli Date: Mon, 23 Feb 2026 12:02:07 +0100 Subject: [PATCH] Rename stale swe-skills references to agent-skills The repository was renamed from swe-skills to agent-skills but internal references were never updated. This caused: - session-start.sh to silently fail (path using-swe-skills/ did not exist; the directory is using-agent-skills/) - slash commands to invoke non-existent swe-skills: namespace - docs and setup guides to point at the old clone URL Rename all occurrences across 14 files: commands, CLAUDE.md, README tree, docs/, and hooks/. --- .claude/commands/build.md | 4 ++-- .claude/commands/plan.md | 2 +- .claude/commands/review.md | 2 +- .claude/commands/ship.md | 2 +- .claude/commands/spec.md | 2 +- .claude/commands/test.md | 4 ++-- CLAUDE.md | 4 ++-- README.md | 2 +- docs/copilot-setup.md | 14 +++++++------- docs/cursor-setup.md | 12 ++++++------ docs/getting-started.md | 8 ++++---- docs/skill-anatomy.md | 2 +- docs/windsurf-setup.md | 10 +++++----- hooks/session-start.sh | 10 +++++----- 14 files changed, 39 insertions(+), 39 deletions(-) diff --git a/.claude/commands/build.md b/.claude/commands/build.md index 59c6a59d..9f8e5f59 100644 --- a/.claude/commands/build.md +++ b/.claude/commands/build.md @@ -2,7 +2,7 @@ description: Implement the next task incrementally — build, test, verify, commit --- -Invoke the swe-skills:incremental-implementation skill alongside swe-skills:test-driven-development. +Invoke the agent-skills:incremental-implementation skill alongside agent-skills:test-driven-development. Pick the next pending task from the plan. For each task: @@ -15,4 +15,4 @@ Pick the next pending task from the plan. For each task: 7. Commit with a descriptive message 8. Mark the task complete and move to the next one -If any step fails, follow the swe-skills:debugging-and-error-recovery skill. +If any step fails, follow the agent-skills:debugging-and-error-recovery skill. diff --git a/.claude/commands/plan.md b/.claude/commands/plan.md index 168c0fd2..99b2ea1e 100644 --- a/.claude/commands/plan.md +++ b/.claude/commands/plan.md @@ -2,7 +2,7 @@ description: Break work into small verifiable tasks with acceptance criteria and dependency ordering --- -Invoke the swe-skills:planning-and-task-breakdown skill. +Invoke the agent-skills:planning-and-task-breakdown skill. Read the existing spec (SPEC.md or equivalent) and the relevant codebase sections. Then: diff --git a/.claude/commands/review.md b/.claude/commands/review.md index 60c6a448..c1d750c8 100644 --- a/.claude/commands/review.md +++ b/.claude/commands/review.md @@ -2,7 +2,7 @@ description: Conduct a five-axis code review — correctness, readability, architecture, security, performance --- -Invoke the swe-skills:code-review-and-quality skill. +Invoke the agent-skills:code-review-and-quality skill. Review the current changes (staged or recent commits) across all five axes: diff --git a/.claude/commands/ship.md b/.claude/commands/ship.md index b2ae4370..6f1ed5cc 100644 --- a/.claude/commands/ship.md +++ b/.claude/commands/ship.md @@ -2,7 +2,7 @@ description: Run the pre-launch checklist and prepare for production deployment --- -Invoke the swe-skills:shipping-and-launch skill. +Invoke the agent-skills:shipping-and-launch skill. Run through the complete pre-launch checklist: diff --git a/.claude/commands/spec.md b/.claude/commands/spec.md index a1d1f2e7..22079353 100644 --- a/.claude/commands/spec.md +++ b/.claude/commands/spec.md @@ -2,7 +2,7 @@ description: Start spec-driven development — write a structured specification before writing code --- -Invoke the swe-skills:spec-driven-development skill. +Invoke the agent-skills:spec-driven-development skill. Begin by understanding what the user wants to build. Ask clarifying questions about: 1. The objective and target users diff --git a/.claude/commands/test.md b/.claude/commands/test.md index fa404e8b..a2b9cfd8 100644 --- a/.claude/commands/test.md +++ b/.claude/commands/test.md @@ -2,7 +2,7 @@ description: Run TDD workflow — write failing tests, implement, verify. For bugs, use the Prove-It pattern. --- -Invoke the swe-skills:test-driven-development skill. +Invoke the agent-skills:test-driven-development skill. For new features: 1. Write tests that describe the expected behavior (they should FAIL) @@ -16,4 +16,4 @@ For bug fixes (Prove-It pattern): 4. Confirm the test passes 5. Run the full test suite for regressions -For browser-related issues, also invoke swe-skills:browser-testing-with-devtools to verify with Chrome DevTools MCP. +For browser-related issues, also invoke agent-skills:browser-testing-with-devtools to verify with Chrome DevTools MCP. diff --git a/CLAUDE.md b/CLAUDE.md index f5d67630..3561989a 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,6 +1,6 @@ -# swe-skills +# agent-skills -This is the swe-skills project — a collection of production-grade engineering skills for AI coding agents. +This is the agent-skills project — a collection of production-grade engineering skills for AI coding agents. ## Project Structure diff --git a/README.md b/README.md index 94f140d5..edc4cfa5 100644 --- a/README.md +++ b/README.md @@ -186,7 +186,7 @@ agent-skills/ │ └── commands/ # Slash commands ├── skills/ # Core skills (SKILL.md per directory) │ ├── idea-refine/ # Define phase: Idea refinement -│ ├── using-swe-skills/ # Meta: how to use this pack +│ ├── using-agent-skills/ # Meta: how to use this pack │ ├── spec-driven-development/ # Define phase │ ├── planning-and-task-breakdown/ # Plan phase │ ├── context-engineering/ # Build phase diff --git a/docs/copilot-setup.md b/docs/copilot-setup.md index ee3a4f71..2509a007 100644 --- a/docs/copilot-setup.md +++ b/docs/copilot-setup.md @@ -1,4 +1,4 @@ -# Using swe-skills with GitHub Copilot +# Using agent-skills with GitHub Copilot ## Setup @@ -10,20 +10,20 @@ GitHub Copilot supports project-level instructions via `.github/copilot-instruct mkdir -p .github # Create instructions file with essential skills -cat /path/to/swe-skills/skills/test-driven-development/SKILL.md > .github/copilot-instructions.md +cat /path/to/agent-skills/skills/test-driven-development/SKILL.md > .github/copilot-instructions.md echo "\n---\n" >> .github/copilot-instructions.md -cat /path/to/swe-skills/skills/code-review-and-quality/SKILL.md >> .github/copilot-instructions.md +cat /path/to/agent-skills/skills/code-review-and-quality/SKILL.md >> .github/copilot-instructions.md ``` ### Agent Personas (agents.md) -Copilot supports specialized agent personas. Use the swe-skills agents: +Copilot supports specialized agent personas. Use the agent-skills agents: ```bash # Copy agent definitions -cp /path/to/swe-skills/agents/code-reviewer.md .github/agents/code-reviewer.md -cp /path/to/swe-skills/agents/test-engineer.md .github/agents/test-engineer.md -cp /path/to/swe-skills/agents/security-auditor.md .github/agents/security-auditor.md +cp /path/to/agent-skills/agents/code-reviewer.md .github/agents/code-reviewer.md +cp /path/to/agent-skills/agents/test-engineer.md .github/agents/test-engineer.md +cp /path/to/agent-skills/agents/security-auditor.md .github/agents/security-auditor.md ``` Invoke agents in Copilot Chat: diff --git a/docs/cursor-setup.md b/docs/cursor-setup.md index 5da2442f..bd419e3c 100644 --- a/docs/cursor-setup.md +++ b/docs/cursor-setup.md @@ -1,4 +1,4 @@ -# Using swe-skills with Cursor +# Using agent-skills with Cursor ## Setup @@ -11,9 +11,9 @@ Cursor supports a `.cursor/rules/` directory for project-specific rules: mkdir -p .cursor/rules # Copy skills you want as rules -cp /path/to/swe-skills/skills/test-driven-development/SKILL.md .cursor/rules/test-driven-development.md -cp /path/to/swe-skills/skills/code-review-and-quality/SKILL.md .cursor/rules/code-review-and-quality.md -cp /path/to/swe-skills/skills/incremental-implementation/SKILL.md .cursor/rules/incremental-implementation.md +cp /path/to/agent-skills/skills/test-driven-development/SKILL.md .cursor/rules/test-driven-development.md +cp /path/to/agent-skills/skills/code-review-and-quality/SKILL.md .cursor/rules/code-review-and-quality.md +cp /path/to/agent-skills/skills/incremental-implementation/SKILL.md .cursor/rules/incremental-implementation.md ``` Rules in this directory are automatically loaded into Cursor's context. @@ -24,9 +24,9 @@ Create a `.cursorrules` file in your project root with the essential skills inli ```bash # Generate a combined rules file -cat /path/to/swe-skills/skills/test-driven-development/SKILL.md > .cursorrules +cat /path/to/agent-skills/skills/test-driven-development/SKILL.md > .cursorrules echo "\n---\n" >> .cursorrules -cat /path/to/swe-skills/skills/code-review-and-quality/SKILL.md >> .cursorrules +cat /path/to/agent-skills/skills/code-review-and-quality/SKILL.md >> .cursorrules ``` ### Option 3: Notepads diff --git a/docs/getting-started.md b/docs/getting-started.md index c8bfbb00..f577b1c6 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -1,6 +1,6 @@ -# Getting Started with swe-skills +# Getting Started with agent-skills -swe-skills works with any AI coding agent that accepts Markdown instructions. This guide covers the universal approach. For tool-specific setup, see the dedicated guides. +agent-skills works with any AI coding agent that accepts Markdown instructions. This guide covers the universal approach. For tool-specific setup, see the dedicated guides. ## How Skills Work @@ -13,7 +13,7 @@ Each skill is a Markdown file (`SKILL.md`) that describes a specific engineering ### 1. Clone the repository ```bash -git clone https://github.com/addyosmani/swe-skills.git +git clone https://github.com/addyosmani/agent-skills.git ``` ### 2. Choose a skill @@ -37,7 +37,7 @@ Copy the relevant `SKILL.md` content into your agent's system prompt, rules file ### 4. Use the meta-skill for discovery -Start with the `using-swe-skills` skill loaded. It contains a flowchart that maps task types to the appropriate skill. +Start with the `using-agent-skills` skill loaded. It contains a flowchart that maps task types to the appropriate skill. ## Recommended Setup diff --git a/docs/skill-anatomy.md b/docs/skill-anatomy.md index 0ab86490..b06ce6b9 100644 --- a/docs/skill-anatomy.md +++ b/docs/skill-anatomy.md @@ -1,6 +1,6 @@ # Skill Anatomy -This document describes the structure and format of swe-skills skill files. Use this as a guide when contributing new skills or understanding existing ones. +This document describes the structure and format of agent-skills skill files. Use this as a guide when contributing new skills or understanding existing ones. ## File Location diff --git a/docs/windsurf-setup.md b/docs/windsurf-setup.md index 5cfb889b..c640e48e 100644 --- a/docs/windsurf-setup.md +++ b/docs/windsurf-setup.md @@ -1,4 +1,4 @@ -# Using swe-skills with Windsurf +# Using agent-skills with Windsurf ## Setup @@ -8,11 +8,11 @@ Windsurf uses `.windsurfrules` for project-specific agent instructions: ```bash # Create a combined rules file from your most important skills -cat /path/to/swe-skills/skills/test-driven-development/SKILL.md > .windsurfrules +cat /path/to/agent-skills/skills/test-driven-development/SKILL.md > .windsurfrules echo "\n---\n" >> .windsurfrules -cat /path/to/swe-skills/skills/incremental-implementation/SKILL.md >> .windsurfrules +cat /path/to/agent-skills/skills/incremental-implementation/SKILL.md >> .windsurfrules echo "\n---\n" >> .windsurfrules -cat /path/to/swe-skills/skills/code-review-and-quality/SKILL.md >> .windsurfrules +cat /path/to/agent-skills/skills/code-review-and-quality/SKILL.md >> .windsurfrules ``` ### Global Rules @@ -28,7 +28,7 @@ Keep `.windsurfrules` focused on 2-3 essential skills to stay within context lim ``` # .windsurfrules -# Essential swe-skills for this project +# Essential agent-skills for this project [Paste test-driven-development SKILL.md] diff --git a/hooks/session-start.sh b/hooks/session-start.sh index 32a9bf09..1b482b06 100755 --- a/hooks/session-start.sh +++ b/hooks/session-start.sh @@ -1,10 +1,10 @@ #!/bin/bash -# swe-skills session start hook -# Injects the using-swe-skills meta-skill into every new session +# agent-skills session start hook +# Injects the using-agent-skills meta-skill into every new session SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)" SKILLS_DIR="$(dirname "$SCRIPT_DIR")/skills" -META_SKILL="$SKILLS_DIR/using-swe-skills/SKILL.md" +META_SKILL="$SKILLS_DIR/using-agent-skills/SKILL.md" if [ -f "$META_SKILL" ]; then CONTENT=$(cat "$META_SKILL") @@ -12,9 +12,9 @@ if [ -f "$META_SKILL" ]; then cat <