← All skills

adding-a-tool

100 / 100 · Low risk

Fine to try.

By grasp-technologies/grasp-agents (GitHub) · coding · 13 stars · scanned at commit e921188

Conventions for adding or changing a grasp-agents tool — @function_tool vs a BaseTool subclass, agent-facing description vs developer docstring, stateless tools that read per-agent state from agent_ctx, timeouts and background/spill axes, untrusted output, concurrency conflict keys, and deferring durable side effects with defer_effect. Use when writing a new tool, a tool set, or changing how a built-in tool behaves.

Works with any agent that supports SKILL.md skills.

What this skill can do

We found nothing in the files we read that matches our rules. That does not prove the skill is safe: see the limits of static scanning.

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'adding-a-tool' ] || [ -L ~/.agents/skills/'adding-a-tool' ]; then echo 'A skill folder named adding-a-tool already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/grasp-technologies/grasp-agents' "$d" && git -C "$d" checkout --quiet 'e92118807db5c49e5b5e0f4c346d9dafd8579d78' -- '.claude/skills/adding-a-tool' && mkdir -p ~/.agents/skills && cp -R "$d"/'.claude/skills/adding-a-tool' ~/.agents/skills/'adding-a-tool' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'adding-a-tool' ~/.claude/skills/'adding-a-tool' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for grasp-technologies/grasp-agents shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/grasp-technologies/grasp-agents.svg)](https://zalavijaysinh.github.io/skilltrust/repos/grasp-technologies/grasp-agents/)

Score history