Open
Conversation
added 3 commits
February 1, 2026 11:02
- Updated the README to include Cursor in the installation note. - Added a new INSTALL.md file for detailed installation instructions for Cursor. - Introduced a superpowers-bootstrap.md file outlining critical rules and skill discovery for Cursor. - Created a superpowers.mdc rules file to define the superpowers system and its application. - Added comprehensive documentation in README.cursor.md for using Superpowers with Cursor IDE.
- Added symlink and copy instructions for superpowers subagents and commands in INSTALL.md. - Updated usage section to clarify automatic discovery of skills, subagents, and commands. - Revised priority order section to include subagents and commands for better clarity. - Expanded superpowers-bootstrap.md to detail subagent and command systems, including their invocation and locations.
- Added spacing for improved readability in INSTALL.md. - Clarified symlink and copy instructions for skills, subagents, and commands. - Enhanced the automatic discovery section in superpowers-bootstrap.md to emphasize skill, subagent, and command locations. - Updated priority order for skills, subagents, and commands for better clarity.
📝 WalkthroughWalkthroughAdds Cursor-specific Superpowers documentation, a new policy file, and bootstrap notes: installation options (global/project), discovery locations and precedence, invocation syntax for skills/subagents/commands, mandatory workflows and update_todo behavior, and README updates linking the new docs. Changes
Sequence Diagram(s)(omitted) Estimated code review effort🎯 3 (Moderate) | ⏱️ ~22 minutes Poem
🚥 Pre-merge checks | ✅ 3✅ Passed checks (3 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 4
🤖 Fix all issues with AI agents
In `@docs/README.cursor.md`:
- Around line 182-193: The "```bash" code fence opened under the "## Updating"
section is never closed, causing the "Rules not working" list to render as code;
close that fence immediately after the git pull line (i.e., add a closing ```
after "git pull"), then move the troubleshooting steps out of the code block and
convert the "Rules not working" title into a proper section header (e.g., "##
Troubleshooting" or "### Rules not working") so the three list items render as
normal markdown.
- Around line 40-63: The fenced code block starting with "```bash" incorrectly
contains the "##### 4. Symlink Superpowers Skills" heading and the
"<EXTREMELY_IMPORTANT>" block; close the code fence immediately after the ln -s
command (end the "```bash" block), move the "##### 4. Symlink Superpowers
Skills" heading above the fence, and remove the "<EXTREMELY_IMPORTANT>" markers
from inside the fence so the EXTREMELY_IMPORTANT content is rendered as a
separate block (restore a standalone <EXTREMELY_IMPORTANT>...
</EXTREMELY_IMPORTANT> section containing the checklist lines and the Available
superpowers sentence). Ensure the subsequent "##### 5. Symlink Superpowers
Rules" and its "```bash" block remain outside the EXTREMELY_IMPORTANT block.
- Around line 9-11: Several fenced code blocks in README.cursor.md (for example
the block starting "Fetch and follow instructions from
https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.cursor/INSTALL.md")
are missing a language specifier and trigger markdownlint MD040; add an
appropriate language token (use "text" for plain output blocks or "bash" for
shell snippets) immediately after each opening ``` so every triple-backtick
fence in the file is annotated consistently.
- Around line 81-99: The fenced code block is not closed and the XML-like tag
EXTREMELY_IMPORTANT is inside the code fence; close the open triple-backtick
after the cp command so the following prose is rendered normally, then move the
<EXTREMELY_IMPORTANT>...</EXTREMELY_IMPORTANT> block outside the fenced code
block and reformat its internal lines as normal Markdown (line breaks or list
items) so the three checklist lines render as text rather than code.
added 2 commits
February 1, 2026 11:31
- Add complete installation steps for subagents and commands in both global and project setups - Expand automatic discovery section to include subagents and commands - Add manual invocation instructions for subagents (@mention) and commands (/command-name) - Update bootstrap section to reference all three systems - Add priority subsections for subagents and commands - Update directory structure diagrams to show agents/ and commands/ directories - Fix updating section formatting and add missing project installation commands - Add troubleshooting subsections for subagents and commands - Ensure proper alignment with INSTALL.md, superpowers-bootstrap.md, and superpowers.mdc
…discovery and usage - Expanded the automatic discovery section to include subagents and commands at both project and global levels. - Added detailed invocation instructions for skills, subagents, and commands. - Revised critical rules to emphasize the use of relevant skills, subagents, and commands. - Updated the list of available skills to reflect recent additions and improvements.
Author
|
@coderabbitai review |
✅ Actions performedReview triggered.
|
There was a problem hiding this comment.
Actionable comments posted: 3
🤖 Fix all issues with AI agents
In `@docs/README.cursor.md`:
- Around line 78-80: Remove the duplicated heading "##### 2. Create Skills
Directory" in the README cursor doc: keep a single instance of the heading and
delete the extra copy so the section appears once; locate the duplicate
occurrences of the exact heading text and remove the redundant one, ensuring
surrounding markdown and the following code block remain intact.
- Around line 273-275: Convert the three bare URLs on the listed lines to proper
Markdown link syntax by replacing each plain URL with an inline link using the
visible text already present: change "Report issues:
https://github.com/obra/superpowers/issues" to "Report issues:
[https://github.com/obra/superpowers/issues](https://github.com/obra/superpowers/issues)"
(or preferably "Report issues: [Report
issues](https://github.com/obra/superpowers/issues)"), change "Main
documentation: https://github.com/obra/superpowers" to use "[Main
documentation](https://github.com/obra/superpowers)", and change "Blog post:
https://blog.fsck.com/2025/10/27/skills-for-openai-codex/" to "[Blog
post](https://blog.fsck.com/2025/10/27/skills-for-openai-codex/)"; this will
satisfy markdownlint MD034 and preserve the visible text while converting to
proper link syntax.
- Line 66: Remove the stray closing code fence (``` ) that has no matching
opening fence before the "#### Option 2: Project-Specific Installation" section;
locate the lone closing backticks and delete them so the markdown heading and
following content render correctly (search for the lone ``` near the "Option 2:
Project-Specific Installation" heading to find the exact spot).
added 3 commits
February 1, 2026 11:50
- Remove incorrect @mention syntax references for subagents (which is for files/folders/code/docs) - Add correct /name syntax and natural language requests for subagent invocation - Document subagent file format with YAML frontmatter and configuration options - Add documentation for built-in subagents (explore, bash, browser) - Add parallel execution guidance with examples - Expand invocation examples throughout documentation - Update troubleshooting section to clarify @ syntax usage
… docs - Update .cursor/superpowers-bootstrap.md: Remove incorrect @mention syntax, add correct /name syntax and parallel execution guidance - Update .cursor/rules/superpowers.mdc: Remove incorrect @mention syntax, replace with correct /name syntax and natural language requests - Update .cursor/INSTALL.md: Add subagent invocation examples using correct /name syntax
…perpowers - Added important note regarding the use of copy-based setup instead of symlinks for skills, agents, commands, and rules to ensure proper discovery. - Updated installation steps in INSTALL.md and README.cursor.md to reflect changes from symlink to copy instructions for skills, agents, commands, and rules. - Included additional instructions for syncing copies after updates in both global and project installations.
Author
|
@coderabbitai review |
✅ Actions performedReview triggered.
|
added 2 commits
February 1, 2026 12:11
- Changed code block syntax from generic to 'text' for better readability in installation instructions and skill directory structure. - Ensured consistency in documentation formatting to enhance user experience.
- Convert bare URLs to proper Markdown link syntax - Add comprehensive Cursor documentation links (skills, commands, agents, rules) - Remove irrelevant blog post link - Improve Getting Help section with relevant Cursor AI documentation
Author
|
hey @obra |
This was referenced Feb 1, 2026
Contributor
|
I think when cursor has skills (which are already available in the nightly build) this process will be irrelevant. You should try it out, I did and it's pretty good. I don't anticipate needing many (if any) changes at all for using superpowers. |
Author
|
@mycarrysun the process is just a long copy paste script, nothing fancy, but I actually created a much simpler script I'm running from my repos: #!/bin/bash
# Script to copy skills, commands, and agents from obra/superpowers to .cursor
# Uses npx tiged to download specific directories from GitHub
set -e # Exit on any error
echo "Copying superpowers skills, commands, and agents to .cursor..."
# Copy skills directory
echo "Copying skills..."
npx tiged obra/superpowers/skills .cursor/skills/superpowers --force
# Copy commands directory
echo "Copying commands..."
npx tiged obra/superpowers/commands .cursor/commands/superpowers --force
# Copy agents directory
echo "Copying agents..."
npx tiged obra/superpowers/agents .cursor/agents --force
echo "Successfully copied superpowers assets to .cursor!"
echo "Skills copied to: .cursor/skills/superpowers/"
echo "Commands copied to: .cursor/commands/superpowers/"
echo "Agents copied to: .cursor/agents/" |
|
@YogliB, how will we handle hooks that rely on the |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Motivation and Context
This PR adds comprehensive Cursor IDE support to Superpowers, enabling Cursor users to leverage the full Superpowers skill ecosystem. Cursor is a popular AI-assisted development environment, and this integration provides the same productivity benefits that Claude Code, Codex, and OpenCode users already enjoy.
What Changed
This PR introduces complete Cursor IDE integration through the following additions:
New Files
.cursor/INSTALL.md(198 lines) - Complete installation guide with two installation options:.cursor/rules/superpowers.mdc(28 lines) - Cursor rules file that defines the Superpowers System with critical rules for skill discovery, invocation, and mandatory workflows.cursor/superpowers-bootstrap.md(54 lines) - Bootstrap documentation explaining the skill, subagent, and command systems, including priority order and location detailsdocs/README.cursor.md(353 lines) - Comprehensive documentation covering:Modified Files
README.md- Updated installation section to include Cursor alongside other platforms, with quick install instructions and link to detailed documentationHow Has This Been Tested?
Breaking Changes
None. This is a purely additive change that introduces new platform support without modifying existing functionality.
Types of changes
Checklist
Summary by CodeRabbit
Release Notes
✏️ Tip: You can customize this high-level summary in your review settings.