Agent skill

Add Agent Adapter

by safedep in safedep/gryph

A skill your agent uses when adding support for a new AI coding agent to Gryph, or when changing how an existing agent adapter is wired.

Apache-2.0Auto-check passedSales & Support

Install Add Agent Adapter

skills CLI
$ npx skills add safedep/gryph --skill add-agent-adapter -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install safedep/gryph add-agent-adapter --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/safedep/gryph.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/add-agent-adapter .claude/skills/add-agent-adapter && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
add-agent-adapter
GitHub stars
172
Token cost
~679 tokens
SKILL.md length
320 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when adding support for a new AI coding agent to Gryph, or when changing how an existing agent adapter is wired.

  • Works in 4 steps: Read docs/agent-adapter.md in full. → Follow each step in order. Use the… → Use an existing adapter as your… → …
  • Adding support for a new AI coding agent to Gryph
  • SKILL.md covers How to use this skill, Invariants and Keep the doc correct
  • Calls go

What it does

Add Agent Adapter is an agent skill from safedep/gryph. Use when adding support for a new AI coding agent to Gryph, or when changing how an existing agent adapter is wired. Trigger this whenever the user wants to integrate a new agent (for example Claude Code, Cursor, Gemini, Codex, Windsurf, or any other tool), add a new adapter package under agent/, wire agent hook events, or asks how adapters detect, install hooks, parse events, or register. Also trigger on phrases like "add a new agent", "support agent X", "new adapter", or "hook up agent X to gryph", even when…

Its SKILL.md is about 680 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Sales & Support, covering Customer support. The repository describes itself as: Security layer for AI coding agents. Works with Claude Code, Cursor, Windsurf, Gemini CLI, OpenCode, Pi Agent and more. The licence is Apache-2.0.

When your agent uses it

  • Adding support for a new AI coding agent to Gryph
  • Changing how an existing agent adapter is wired
  • This whenever the user wants to integrate a new agent (for example Claude Code
  • Any other tool)

Example prompts

  • “add a new agent”
  • “support agent X”
  • “new adapter”
  • “/add-agent-adapter”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Read docs/agent-adapter.md in full.
  2. Follow each step in order. Use the wiring table in the doc to change every listed file.
  3. Use an existing adapter as your reference. The agent/gemini/ package is the recommended model for the settings.json pattern.
  4. Run the verify commands from the doc's final step before you finish.

What it can do on your machine

Read from SKILL.md and the folder at commit 426480f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • go

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Add Agent Adapter loads about 679 tokens when it runs. Until then it costs about 144 tokens; SKILL.md has 320 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~144
When it runs · the whole SKILL.md, loaded when a task matches
~679

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from safedep/gryph at commit 426480f, republished under its Apache-2.0 licence (© safedep). 320 words, ~679 tokens.

Download SKILL.mdSave it as .claude/skills/add-agent-adapter/SKILL.md (or your agent's skills folder).
name
add-agent-adapter
description
Use when adding support for a new AI coding agent to Gryph, or when changing how an existing agent adapter is wired. Trigger this whenever the user wants to integrate a new agent (for example Claude Code, Cursor, Gemini, Codex, Windsurf, or any other tool), add a new adapter package under agent/, wire agent hook events, or asks how adapters detect, install hooks, parse events, or register. Also trigger on phrases like "add a new agent", "support agent X", "new adapter", or "hook up agent X to gryph", even when the user does not say the word "adapter".

Add a New Agent Adapter

The full, current guide is docs/agent-adapter.md. It is the single source of truth for this task. Read it and follow it step by step.

Do not add an agent adapter from memory. The adapter pattern touches several files across agent/, config/, cli/, and tui/. A missed file breaks detection, registration, or the security response path. The doc lists every file and the exact change each one needs.

How to use this skill

  1. Read docs/agent-adapter.md in full.
  2. Follow each step in order. Use the wiring table in the doc to change every listed file.
  3. Use an existing adapter as your reference. The agent/gemini/ package is the recommended model for the settings.json pattern.
  4. Run the verify commands from the doc's final step before you finish.

Invariants

The doc explains these. They break silently if you miss them.

  1. Implement HookConfigPaths() and return a glob for every file the install step writes. Self-protection guards only these paths. TestAdapters_InstallWritesOnlyDeclaredHookConfig fails when a written file has no glob.
  2. Implement Hooks() with one events.HookSpec per hook, including its phase. The decision service reads the phase from it. Regenerate docs/agent-enforcement-coverage.md with GRYPH_UPDATE_DOCS=1 go test ./cli -run TestEnforcementCoverageDoc.
  3. Keep agent knowledge in the adapter package. Do not add agent paths, file names, or command regexes to aarm/loader or aarm/pdp. The loader derives the shell-command check from the declared paths, and aarm/shellcmd parses commands with mvdan.cc/sh. Do not match shell commands with a regex.
  4. Register the adapter only in registerAdapters in cli/root.go. The self-protection globs come from that list.
  5. Self-protection is best effort. Do not describe it as a security boundary. Kernel-based self-protection is on the roadmap.

Keep the doc correct

The doc is the source of truth, so keep it accurate. If you find the code no longer matches the doc, update docs/agent-adapter.md in the same change. Do not fork the guidance into this skill.

© safedep, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/add-agent-adapter of safedep/gryph.

Open the folder on GitHubat commit 426480f

Compare with similar skills

Add Agent Adapter next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Add Agent Adapter compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Add Agent Adapter this skillsafedep/gryph172—~679Automated safety check: PassApache-2.0
Siftranknoperator/siftrank225—~2.9kAutomated safety check: PassMIT
Supporthaacked/dotfiles134—~2.9kAutomated safety check: PassNone
Customer Support Agentmastra-ai/mastra29k—~2.2kAutomated safety check: PassCustom licence
Agent Support Matrixjazzyalex/agent-sessions895—~587Automated safety check: PassMIT
Company Brain Company QAtopoteretes/cognee32k—~750Automated safety check: NotesApache-2.0

Similar skills

  • Siftrank

    noperator/siftrank

    Find needles in haystacks with SiftRank. An agent skill from noperator/siftrank.

    225 GitHub stars~2.9k tokensUpdated 20 days ago
    Sales & SupportAuto-check passed
  • Support

    haacked/dotfiles

    Support hero workflow — start a ticket investigation with auto-organized notes, find existing notes, or generate the weekly highlights log.

    134 GitHub stars~2.9k tokensUpdated today
    Sales & SupportAuto-check passed
  • Customer Support Agent

    mastra-ai/mastra

    Authoring playbook for building agents that triage and reply to customer messages — support tickets, email inquiries, chat questions, refund requests, or product issues.

    29k GitHub stars~2.2k tokensUpdated today
    Sales & SupportAuto-check passed
  • Agent Support Matrix

    jazzyalex/agent-sessions

    Maintain Agent Sessions agent support matrix and JSON/JSONL parsing compatibility.

    895 GitHub stars~587 tokensUpdated yesterday
    Sales & SupportAuto-check passed
  • Company Brain Company QA

    topoteretes/cognee

    Build one company memory from a SQL database, a support ticket export and a folder of documents, linked into one graph by cognee, then answer questions that need several of those sources together.

    32k GitHub stars~750 tokensUpdated today
    Sales & SupportAuto-check: notes
  • Shopify Admin Address Correction

    40RTY-ai/shopify-admin-skills

    Update the shipping address on an unfulfilled order before it ships.

    194 GitHub stars~1.5k tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed

More from safedep/gryph

  • Aarm Policy Layer

    safedep/gryph

    A skill your agent uses when working on Gryph's AARM security layer or policy engine.

    172 GitHub stars~921 tokensUpdated 5 days ago
    Auto-check passed

Categories

Questions about Add Agent Adapter

What does Add Agent Adapter do?

A skill your agent uses when adding support for a new AI coding agent to Gryph, or when changing how an existing agent adapter is wired. Add Agent Adapter is an agent skill from safedep/gryph. Use when adding support for a new AI coding agent to Gryph, or when changing how an existing agent adapter is wired.

When should I use Add Agent Adapter?

Add Agent Adapter fits situations like: adding support for a new AI coding agent to Gryph; changing how an existing agent adapter is wired; this whenever the user wants to integrate a new agent (for example Claude Code; any other tool).

How do I install Add Agent Adapter in Claude Code?

Run `npx skills add safedep/gryph --skill add-agent-adapter -a claude-code`. Or copy the skill folder (.claude/skills/add-agent-adapter in safedep/gryph) into .claude/skills/add-agent-adapter in your project. Claude Code loads it when a task matches its description.

How do I install Add Agent Adapter in Codex?

Run `npx skills add safedep/gryph --skill add-agent-adapter -a codex`. Or copy the skill folder (.claude/skills/add-agent-adapter in safedep/gryph) into .agents/skills/add-agent-adapter in your project. Codex loads it when a task matches its description.

Can I use Add Agent Adapter in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add safedep/gryph --skill add-agent-adapter -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/add-agent-adapter, .gemini/skills/add-agent-adapter, .github/skills/add-agent-adapter and .opencode/skills/add-agent-adapter in your project.

What does Add Agent Adapter need to run?

Going by SKILL.md and its folder, Add Agent Adapter needs the command-line tools its instructions call (go).

Does Add Agent Adapter access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Add Agent Adapter safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Add Agent Adapter use?

Add Agent Adapter is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Add Agent Adapter use?

About 679 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Add Agent Adapter?

Skills that share tags, products or a category with Add Agent Adapter: Siftrank (noperator/siftrank, 225 stars), Support (haacked/dotfiles, 134 stars), Customer Support Agent (mastra-ai/mastra, 29k stars) and Agent Support Matrix (jazzyalex/agent-sessions, 895 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Add Agent Adapter?

safedep (a GitHub organization) maintains it in safedep/gryph, which has 172 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 5, 2026.

Source: safedep/gryph on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.