- 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.
How to use
Skills on Agensi run inside your AI agent. Copy the prompt, paste it into your agent, and it connects to Agensi and installs this skill for you. If a payment is needed, your agent shows it to you first.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill passes our trust checks below.
Security scanned
Passed our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free forever
No account required to browse
Trust & safety
Security scanned
Verified clean 3 days ago
- Free to download with an account
Requires