Skills Constitution
Skills Constitution makes the agent check the skill index and search for a capability before refusing
- 235 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Hook registration edits platform settings and runs scripts on every session start and every prompt.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/skills-constitutionDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Hook registration edits platform settings and runs scripts on every session start and every prompt.
This is third-party code. Review the repository files before installing.
What it does
Skills Constitution is a meta-rule above all skills and tools. It sets the agent order of work: consult memory first, then the skill index and list the matching skills, use a match without fail, search for a fitting skill when none matches, and search before saying "I cannot". Plugins follow the same rule and are invoked by the full name such as `plugin:skill`. The skill index, "the tree", is rebuilt by the installer, which also pulls plugin skills into it. `install.sh` detects the platform and acts by its mechanism: for skill directories it copies files, for rule-file tools such as Cursor, Windsurf and Cline it writes rules into the project, for chat platforms it prepares a paste-in template. The `--register-hooks` flag registers four hooks with backup and rollback. The `session-start` and `user-prompt-submit` hooks strengthen compliance in Claude Code and other platforms with hooks. Elsewhere compliance stays advisory.
Who it is for. People whose agent has accumulated dozens of skills and plugins and who want the agent to pick them before working instead of skipping them.
Good fit when
- The agent often does a task on its own although a fitting skill is installed.
- You want to pin the rule for the agent: search for a capability first, refuse later.
- There are many skills from plugins and they must be called by full name.
- You need a recommendation for a chat platform with no skills directory: the installer prepares a paste-in template.
Not a fit when
- The agent needs a couple of skills: an extra rule only lengthens every answer.
- You cannot change platform hook configuration: hook registration edits its files.
- You need a technical guarantee of compliance: on platforms without hooks the rule stays advisory.
Example request
Before the task consult the skill index, list the matches and use the fitting one, and if none match search for a capability first.Limitations
The rule is strict only where hooks are registered, while on rule-file tools and chat platforms it stays advisory. Hook registration edits platform settings, so run `python scripts/register_hooks.py --dry-run` first, and `--uninstall` removes the hooks. Windows install through `install.ps1` is marked as needing first verification on a real machine. The README is in Chinese with an English version in `README_EN.md`. The skill index reflects the author snapshot and is rebuilt by the installer, and non-standard plugin paths need the `PLUGIN_CACHE_DIRS` variable.
How to disable. Remove hooks with `python skills-constitution/scripts/register_hooks.py --uninstall` and delete the skill folder from the agent skills directory. In rule files delete the constitution block.
FAQ
How do I install Skills Constitution?
Clone the repository and run `bash skills-constitution/install.sh`: the script detects the platform and rebuilds the skill index.
How do I enable enforcement?
Add `--register-hooks` to the install or run `python skills-constitution/scripts/register_hooks.py`.
How do I install the rules in Cursor?
Run `bash install.sh --platform cursor --target-dir <project>`: the rules land in the project rule file.
What about ChatGPT or Gemini?
Run `bash install.sh --platform prompt` to get a template and paste it into the agent instructions.
How do I preview the hook changes?
Run `register_hooks.py` with `--dry-run`: it shows what would change and writes nothing.
Discussion
No questions or reviews yet.
Related
SkillsA meta-skill that folds rules scattered across AGENTS.md, CLAUDE.md and Cursor files into one project skill with task routes.
A skill registry for teams with security scanning and versioning; the MCP server finds and installs skills on request.
A self-improvement plugin for Claude Code, Codex and OpenCode: turns corrections into rules the agent follows in later sessions
A working folder for Claude Code where the agent asks questions and writes a new skill by Anthropic's guidance, not from memory.
The command-line client of the skilld.dev registry that installs agent skills into a project and tracks their changes
A plugin of seven skills for Claude Code and Codex: prompts, subagents, skill authoring, editing, web search and a browser.
README in short
The README shows a quick start split by platform, a paste-in block for any agent rule and a description of the skill index. Version 2.32.1 at the time of review, MIT license.