Skip to content

Latest commit

 

History

History
48 lines (36 loc) · 2.14 KB

File metadata and controls

48 lines (36 loc) · 2.14 KB

Contributing

Thanks for helping improve the delego Claude Code plugin. Contributions to the skills and agents are welcome — more policy templates, broker reviewers, and operating skills make the toolkit more useful.

Important: skills and agents are instructions that run in other people's Claude Code sessions. A contribution is a prompt, not just documentation — review it as you would code that executes on someone else's machine.

How to contribute

  • Fork the repo and open a PR from a branch in your fork.
  • Keep python scripts/validate.py green (CI runs it): the manifests parse, and every skill/agent has valid frontmatter, a kebab-case name, a real description, and unique agent names.
  • Fill in the PR template, including the AI-assistance disclosure.

The bar for a good skill or agent

  • Correct delego semantics. Fail-closed; the evaluation order (forbidden → rules → default deny); the invariants (no LLM in the decision path, no credential custody, fingerprint + intent binding, single-use approvals, an append-only signed audit). Don't describe behaviour delego doesn't have.
  • Honest caveats. Don't oversell — e.g. the audit chain does not detect truncation of the most recent receipts, and the policy can't see the URL query string (until protocol 0.3).
  • Safe instructions. No destructive or credential-exfiltrating guidance, and nothing that bypasses delego.
  • A precise description. It drives auto-delegation — specific enough to fire on the right requests, not so broad it hijacks unrelated ones.

Plugin manifest & MCP server

Changes to the plugin / marketplace manifests or the bundled MCP server config are maintainer-reviewed — they affect every install. Open an issue first.

AI-assisted contributions

AI assistants are welcome tools, but AI-generated skills/agents get stricter review (they're prompts that run for others). Disclose AI use in the PR template, expect closer scrutiny, and own every line — "the model wrote it" is not a defence. Fork + PR + green CI; no fast path.

License

Apache-2.0. By contributing you agree your contribution is licensed under it.