Apply Strunk's style principles to prose

Following The Elements of Style:
- Use active voice (Rule 10): "We rewrote" not "has been rewritten"
- Omit needless words (Rule 13): removed "automatically", "optionally", etc.
- Break up long sentences: split run-on second sentence into short, direct statements
- Put statements in positive form (Rule 11): direct assertions rather than negatives
- Keep it concise: "Claude notifies" not "Claude will notify"

Overview section now more direct and forceful while maintaining all information.
This commit is contained in:
Jesse Vincent
2025-10-11 14:01:36 -07:00
parent 0f30fd2989
commit 488139d6d1
2 changed files with 6 additions and 6 deletions

View File

@@ -2,13 +2,13 @@
## Overview
Superpowers v2.0 represents a major architectural shift focused on making skills more accessible, maintainable, and community-driven.
Superpowers v2.0 makes skills more accessible, maintainable, and community-driven through a major architectural shift.
The headline change is **skills repository separation**: all skills, scripts, and documentation have moved from the plugin into a dedicated repository ([obra/superpowers-skills](https://github.com/obra/superpowers-skills)). This transforms superpowers from a monolithic plugin into a lightweight shim that manages a local clone of the skills repository. Skills now auto-update on session start, users can fork and contribute improvements via standard git workflows, and the entire skills library is versioned independently from the plugin.
The headline change is **skills repository separation**: all skills, scripts, and documentation have moved from the plugin into a dedicated repository ([obra/superpowers-skills](https://github.com/obra/superpowers-skills)). This transforms superpowers from a monolithic plugin into a lightweight shim that manages a local clone of the skills repository. Skills auto-update on session start. Users fork and contribute improvements via standard git workflows. The skills library versions independently from the plugin.
Beyond infrastructure, this release adds nine new skills focused on problem-solving, research, and architecture. The core **using-skills** documentation has been completely rewritten with imperative tone and clearer structure, making it easier for Claude to understand when and how to use skills. Tools like **find-skills** now output paths that can be directly pasted into the Read tool, eliminating friction in the skills discovery workflow.
Beyond infrastructure, this release adds nine new skills focused on problem-solving, research, and architecture. We rewrote the core **using-skills** documentation with imperative tone and clearer structure, making it easier for Claude to understand when and how to use skills. **find-skills** now outputs paths you can paste directly into the Read tool, eliminating friction in the skills discovery workflow.
For users, the experience is seamless: the plugin handles cloning, forking, and updating automatically. For contributors, the new architecture makes it trivial to improve skills and share them back with the community. This release lays the foundation for skills to evolve rapidly as a community resource.
Users experience seamless operation: the plugin handles cloning, forking, and updating automatically. Contributors find the new architecture makes improving and sharing skills trivial. This release lays the foundation for skills to evolve rapidly as a community resource.
## Breaking Changes