taskchad-os: Command for Claude Code

.claude/commands/core_piv_loop/prime-tools.md

prime-tools is a command for Claude Code from TheSmokeDev/taskchad-os. It costs 0 tokens per session (381 once invoked), scanned A, original, MIT.

A command that loads the project's guidance for designing tools used by Pydantic AI agents, a Python framework for AI applications.

In plain words
What is it for?
Preparing to build or change agent tools, including writing usage guidance, warnings, arguments, return values, performance notes, and examples.
Why use it?
It gives the coding agent the project's required documentation patterns, so tool descriptions are easier for agents to understand and choose correctly.

Command for Claude Code

Written for Claude Code: installed under .claude/.

This is TheSmokeDev/taskchad-os's own configuration. It tells Claude Code how to work on taskchad-os itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything taskchad-os configures →

Reuse

Borrowing it

Nothing to install: this file belongs to TheSmokeDev/taskchad-os. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/TheSmokeDev/taskchad-os/master/.claude/commands/core_piv_loop/prime-tools.md
Clone the repo
git clone --depth 1 https://github.com/TheSmokeDev/taskchad-os

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for prime-tools

README.md
[![agentmods](https://agentmods.dev/badge/commands/thesmokedev/taskchad-os/prime-tools.svg)](https://agentmods.dev/commands/thesmokedev/taskchad-os/prime-tools)
Your own site
<a href="https://agentmods.dev/commands/thesmokedev/taskchad-os/prime-tools"><img src="https://agentmods.dev/badge/commands/thesmokedev/taskchad-os/prime-tools.svg" alt="Measured on agentmods" height="20"></a>
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 381 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00000 $0.00381
Opus 5 $0.00000 $0.00191
Sonnet 5 $0.00000 $0.00076
Haiku 4.5 $0.00000 $0.00038

Measured 6d ago against content hash 5836f37931db, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

prime-tools scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/commands/core_piv_loop/prime-tools.md · 52 lines

What it actually says

Prime for Tool Development

Load tool development patterns from Module 3 to prepare for building agent tools.

Context

You are about to work on building or modifying agent tools that will be used by Pydantic AI agents. Load the comprehensive patterns and best practices we established in Module 3 for writing agent-optimized tool docstrings.

Read

Read the tool docstring patterns: @.agents/reference/adding_tools_guide.md

Process

Understand and internalize:

  1. Core Philosophy - How agent tool docstrings differ from standard docstrings
  2. 7 Required Elements - One-line summary, "Use this when", "Do NOT use", Args with guidance, Returns, Performance Notes, Examples
  3. Agent Perspective - Writing for LLM comprehension and tool selection
  4. Token Efficiency - Documenting token costs and optimization strategies
  5. Anti-patterns - Common mistakes that confuse agents
  6. Template Structure - The exact format to follow

Pay special attention to:

  • "Use this when" (affirmative guidance for tool selection)
  • "Do NOT use" (negative guidance to prevent tool confusion)
  • Performance Notes (token costs, execution time, limits)
  • Realistic examples (not "foo", "bar", "test.md")

Report Back

Provide a concise summary with:

Key Principles (5 bullets max)

  • [What are the core principles you understood?]

Critical Distinctions

  • [What makes agent tool docstrings different from standard docstrings?]
  • [Why does "Do NOT use" matter?]

Template Internalized

  • [Confirm you understand the structure you'll follow]

Ready to Apply

  • [One sentence confirming you're ready to write agent-optimized tool docstrings]

Keep it scannable - I want to verify understanding in 30 seconds.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 52 lines · 0 tokens per session scan A 5836f37931db

Subscribe to this mod's changes

prime-tools is a command published in the GitHub repository TheSmokeDev/taskchad-os (23 stars, last pushed 14d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 381 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.