Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    norma - one task loop and verification gate, enforced by git

    1

    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

    1 useSecurity scanned
    norma - one task loop and verification gate, enforced by git

    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:

    1. Install the norma CLI from a tagged release - not master:

      • Homebrew: brew install jcarlosrodicio/tap/norma, or
      • a tagged git clone into ~/.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.
    2. Add the harness: I'll run norma install --dry-run and show you the plan.
      It adds the verification gate (scripts/harness/verify), the pre-commit hook,
      the agent procedures, AGENTS.md, three .gitignore lines, and sets
      core.hooksPath. Then norma 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. 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. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 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

    GitHub
    Git
    POSIX sh
    macOS
    Linux

    Permissions

    Terminal / Shell
    Network Access
    Read Files
    Write Files

    Allowed Hosts

    raw.githubusercontent.com
    github.com

    File Scopes

    scripts/harness/**
    .githooks/**
    .agents/skills/**
    .claude/skills/**
    docs/harness/**
    openspec/config.yaml
    AGENTS.md
    CLAUDE.md
    .gitignore
    .harness/**
    ~/.local/share/norma/**
    ~/.local/bin/norma

    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.

    Listed1 month ago

    What's inside

    Frequently Asked Questions

    A prompt is a request the agent may forget. norma installs a git pre-commit hook that refuses a commit unless the repository's verification gate passed after the last edit to the staged files. The gate runs the project's own checks and the tests named for the change. The hook can still be skipped with git commit --no-verify, so run the same gate in CI to close that gap. The skill sets norma up and drives it; the guarantee comes from the hook and CI, not from the skill.

    Git and a POSIX sh on macOS or Linux; native Windows is not supported. The agent must be able to run shell commands and read and write files. Installing norma needs network access to github.com, or Homebrew. The full task loop also uses OpenSpec. Written for Claude Code, Codex and OpenCode; not tested in every agent listed.

    It reads the refusal norma printed and maps it to its cause and fix: a commit on the default branch, a missing or stale verification, a docs-only run with code staged, a broken config. It never fixes a refusal by bypassing it. norma doctor reports what is missing or misconfigured and changes nothing; to see whether a repository is behind, compare scripts/harness/VERSION with norma version.

    Both. The skill is for agents, but what it installs is plain git: the pre-commit hook and the verification gate apply to every commit, whoever or whatever makes it, and the procedures are Markdown files a person can read and follow. Merging through norma's land script is opt-in, per project.

    Nothing until you approve it. With your yes, norma install adds the verification gate, the run context and the land script under scripts/harness/, the pre-commit hook in .githooks/, the task procedures in .agents/skills/, a project-owned config.sh and docs/harness/ templates, an AGENTS.md section, a few .gitignore lines, and sets git config core.hooksPath. Run norma install --dry-run first to see the exact plan.

    New in Workflow Automation