agent-work-contracts

Agent Plugin packaging the agent-work-contracts skill: turn multi-step or delegated agent work into a bounded contract with concrete validation and a concise handoff.

The skill follows the Agent Skills open standard and is packaged as an Agent Plugins 1.0.0 plugin, so one SKILL.md works across every agent that supports the standard: GitHub Copilot, Claude Code, Cursor, Codex, Gemini CLI, OpenClaw, and more. No agent-specific code.

Layout

agent-work-contracts/
├── plugin.json                      # Agent Plugins 1.0.0 manifest
├── LICENSE
└── skills/
    └── agent-work-contracts/
        └── SKILL.md                 # the portable skill

Install

Any agent, one command

GitHub CLI installs the skill into your agent of choice:

gh skill install AndreaGriffiths11/agent-work-contracts agent-work-contracts \
  --agent codex --scope user

Supported --agent values include github-copilot, claude-code, cursor, codex, gemini-cli, openclaw, goose, opencode, amp, and many more. --scope user makes it available across your projects; --scope project installs it inside the current repository.

Per-agent manual install

Agent	Personal (all projects)	Project (repo-scoped)
Claude Code	`~/.claude/skills/agent-work-contracts/`	`.claude/skills/agent-work-contracts/`
GitHub Copilot	`~/.copilot/skills/` or `~/.agents/skills/`	`.github/skills/`, `.claude/skills/`, or `.agents/skills/`
Cursor	`~/.cursor/skills/` or `~/.agents/skills/`	`.cursor/skills/` or `.agents/skills/`
Codex	`~/.agents/skills/`	`.agents/skills/` at repo root
Gemini CLI	`~/.gemini/skills/` or `~/.agents/skills/`	`.gemini/skills/` or `.agents/skills/`
OpenClaw	`~/.openclaw/skills/`	plugin or skill flow

Copy the whole skills/agent-work-contracts/ folder so SKILL.md sits at <location>/agent-work-contracts/SKILL.md.

Gemini CLI also has a native installer:

gemini skills install https://github.com/AndreaGriffiths11/agent-work-contracts --scope user

Codex has a built-in installer: open Codex and run $skill-installer, then point it at this repository.

Use

Ask your agent to apply the agent-work-contracts skill before substantial implementation, refactoring, investigation, or delegated work. It skips one-file changes with an obvious check.

Validate

gh skill publish --dry-run   # validates the skill against the Agent Skills spec

License

MIT. See LICENSE.