- Home
- Skills
- Workflow Automation
- norma - one task loop and verification gate, enforced by git
Works with the AI Agents you already use
norma - one task loop and verification gate, enforced by git
Sets up and drives norma, the open-source task harness that makes every coding agent follow the same loop and refuses commits that did not pass the same verification gate - enforced by a git hook, not by the agent.
Free
norma - one task loop and verification gate, enforced by git
Example session with this skill installed
Set up norma in this repo so my agents can't commit untested code.
- Read your context and instructions
- Compiled the norma - one
Checked first (changed nothing): norma is not installed, the repo has no harness
(no gate, no pre-commit hook), the tree is clean on master, and it looks like a
Python project (pyproject.toml).
I need your OK on two things before changing anything:
-
Install the norma CLI from a tagged release - not
master:- Homebrew:
brew install jcarlosrodicio/tap/norma, or - a tagged
git cloneinto~/.local/share/norma, linked from~/.local/bin, or - the install script, downloaded and shown to you before it runs.
This needs github.com and writes outside the repo.
- Homebrew:
-
Add the harness: I'll run
norma install --dry-runand show you the plan.
It adds the verification gate (scripts/harness/verify), the pre-commit hook,
the agent procedures,AGENTS.md, three.gitignorelines, and sets
core.hooksPath. Thennorma doctor, and an interview for your real test commands.
One honest limit: the hook refuses commits the gate has not verified, but
git commit --no-verify skips it. Only CI running scripts/harness/verify --full
closes that hole - this repo has no CI yet.
Which install route do you want, and do you approve norma install?
Connects securely to your tools. The creator never sees your data.
About this skill
norma installs a task harness into a git repository: a verification gate that runs the project's own checks and the tests for what changed, a pre-commit hook that refuses a commit without a fresh stamp from that gate, and a library of procedures - orient, enrich, branch, plan, implement, verify, review, document, hand over - that any agent follows by file path.
This skill is the entry point. It lets an agent:
- detect whether norma and its harness are already in the repository, and whether the hook is actually armed;
- install the CLI and add the harness through norma's official routes - Homebrew, a tagged release, or the install script shown to you before it runs - and only after you say yes;
- work through the repository's own loop and gate instead of improvising one;
- explain why a commit was refused and what fixes it, without bypassing anything.
What it does not do: enforce anything by itself. The guarantees come from
the git hook, the gate and your CI; the skill forbids the agent to fake them -
no --no-verify, no hand-written stamp, no edits to the gate - and tells it to
say so when your CI does not run the gate, because then the hook is the only
check.
Free and open source (MIT). POSIX sh, no runtime dependencies beyond git.
No native Windows support (WSL untested). Needs git and a POSIX sh. Installing norma needs network access to github.com, or Homebrew. The skill enforces nothing by itself: the guarantees come from norma's git hook, its verification gate and your CI - git commit --no-verify skips the hook unless CI runs the gate. The gate is only as strong as the checks configured in scripts/harness/config.sh. The full loop uses OpenSpec. Not tested in every agent listed.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
1 use
Times used to date
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 1 month ago
- Free with an Agensi account
Requires
Permissions
Allowed Hosts
File Scopes
Network: only to install the norma CLI from its own GitHub repository (or Homebrew), and only after the user approves. Shell and file writes: norma install/upgrade write the harness files listed in File Scopes and set git config core.hooksPath - each one shown with --dry-run and approved first. The skill never commits, pushes or merges without the user's yes.