Potpie is a tool that turns a software repository and its development history into a context graph for AI coding agents. Agents use that graph to answer codebase questions, plan changes, debug problems, and write code with project-specific information. The catalogue includes skills, hooks, commands, and a plugin for integrating Potpie into coding-agent workflows.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add potpie-ai/potpie --skill potpie-repo-baselinegit clone --depth 1 https://github.com/potpie-ai/potpieWrote 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.
[](https://agentmods.dev/skills/potpie-ai/potpie/potpie-repo-baseline)<a href="https://agentmods.dev/skills/potpie-ai/potpie/potpie-repo-baseline"><img src="https://agentmods.dev/badge/skills/potpie-ai/potpie/potpie-repo-baseline/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/potpie-ai/potpie/potpie-repo-baseline"><img src="https://agentmods.dev/badge/skills/potpie-ai/potpie/potpie-repo-baseline.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00075 | $0.02048 |
| Opus 5.5 | $0.00030 | $0.00819 |
| Sonnet 5.5 | $0.00015 | $0.00410 |
| Haiku 4.5 | $0.00007 | $0.00205 |
Grade A, and why
potpie-repo-baseline 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 10d 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.
How it starts
The opening of the file, as written. The whole thing — 205 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Potpie Repo Baseline
Use this skill when the user asks to ingest, refresh, establish, or deeply understand what a repository is and how it works.
Procedure
- Check the pot and register the source:
potpie status
potpie source add repo .
potpie status reports the daemon, the active pot, backend readiness and claim
counts. source add repo . records metadata only — it does not ingest or scan —
and sets the repo-local default pot; add --pot <pot-id-or-name> only when the
repo must land in a non-default pot. Every later read names the pot it used in
its header, so do not pre-read pot info, source list or graph status.
- Inspect the full destination ontology and classify the source claims with ontology selection, then take payload shapes from templates:
potpie --json graph catalog --profile full --pot <pot>
potpie graph mutation-template --kind repo-baseline
potpie graph mutation-template --kind feature
potpie graph mutation-template --kind infra-snapshot
The catalog supplies the complete public vocabulary and allowed endpoints;
templates are examples, not ontology coverage. Reuse the catalog through the
task, including for relationships absent from templates. propose validates
the shape but cannot decide whether a fact was misclassified as a preference.
graph describe --examples has no mutation example.
- Create todos for the baseline lanes: docs/product, repo map, runtime/deploy, API/data/integrations, preferences/workflows, synthesis, identity resolution, write, verify.
- Read authored sources first, then inspect source files that are authoritative for durable facts: routes, service clients, adapters, deployment targets, API contracts, model/datastore usage, and test/workflow commands.
- Resolve identity before writing — one untyped search per entity you intend
to link and have not already seen in a read (a wrong
--typeguess returns nothing):
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.
- 10d ago Changed · +11 lines f75619a8a7b7
- 14d ago Changed · +40 lines e6848d785f8f
- 1mo ago First seen · 154 lines · 75 tokens per session scan A 09d6ff500b3f
potpie-repo-baseline is a skill published in the GitHub repository potpie-ai/potpie (5,769 stars, last pushed today), licensed Apache-2.0. It adds 75 tokens to every session and 2,048 once invoked, about $0.0003 per session on Opus 5.5. 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.
Other skills, from other repositories
oracle-mcp-server-helper
Wire the oracle-database-mcp-server into a Python project so an LLM agent can call listtables / describetable / runsql / vectorsearch at inference time. Handles install, stdio launch, and LangChain tool conversion via langchain-mcp-adapters. Use whenever a project needs a Grok 4 / GPT-class agent that talks to a live…
memory
Use memory-as-tool to add and search memories throughout the Codex session.
langchain_patterns
Implement Retrieval-Augmented Generation (RAG) systems with LangChain4j. Build document ingestion pipelines, embedding stores, vector search strategies, and knowledge-enhanced AI applications. Use when creating question-answering systems over document collections or AI assistants with external knowledge bases.
langchain_patterns
Implement Retrieval-Augmented Generation (RAG) systems with LangChain4j. Build document ingestion pipelines, embedding stores, vector search strategies, and knowledge-enhanced AI applications. Use when creating question-answering systems over document collections or AI assistants with external knowledge bases.
scope-creep-detector
Analyzes git diffs against a stated intent to detect scope creep, unrelated files, broad pull requests, changes that grew beyond a fix, dependency additions, public API renames, config or CI edits, oversized hunks, and formatting-only files. Use when the user asks whether a change grew beyond the fix, a PR is too…
mem0-status
Diagnoses mem0 connectivity, API key validity, and memory read/write functionality. Use when memory operations fail, searches return empty, addmemory errors occur, or to verify the plugin is working correctly.