Description
superself is an agent skill from the wshobson/agents collection that teaches an agent how to read and write a project's state through the Superself command-line tool. Superself is an Apache-2.0 CLI, installed from npm, that version-controls a project's goals, decisions, work units and reports as an append-only event log in a git repository kept separate from the code. Because the state is derived on demand from that log, nothing in it is maintained by hand. The skill applies when a project's AGENTS.md or CLAUDE.md contains a Superself block, or when the self setup command resolves the project's workspace and store. It tells the agent to check the command's help before relying on any verb or flag, since the skill is written against Superself 0.6.1 and later versions may change them. It also tells the agent to skip the skill when the self command is not available, because the project does not use Superself and nothing should be invented by hand. The skill is maintained by the Superself authors. It is installed with the skills CLI from the wshobson/agents repository, and its skills.sh page showed about 1.2K installs and passing results from three security audits at the time of the scan.…
Highlights
- Reads and writes project state through the self CLI
- Append-only event log in a separate git repository
- Goals, decisions, work units and reports
- Activates from an AGENTS.md or CLAUDE.md block
- Written against Superself 0.6.1
- Installs with the skills CLI
Ratings & Reviews
No ratings yet
Be the first to rate superself.
People also visit
superself FAQ
What is Superself?
An Apache-2.0 command-line tool, installed from npm, that stores a project's goals, decisions, work units and reports as an append-only event log in git.
What do I need installed?
The Superself CLI, which the site installs with npm and requires Node 22.12 or later. The skill is written against version 0.6.1.
When does the skill apply?
When the project's AGENTS.md or CLAUDE.md has a Superself block, or when self setup resolves the project's directory.
What if the project does not use Superself?
The skill says to skip it, because nothing should be invented by hand when the self command is missing.
How do I install it?
Run npx skills add https://github.com/wshobson/agents --skill superself.
What security audits does it have?
skills.sh lists three audits: Gen Agent Trust Hub Pass, Socket Pass and Snyk Pass.
What are the best superself alternatives?
Popular alternatives to superself include block-no-verify-hook, git-advanced-workflows and grounded-vault. See all superself alternatives