Agent Squad Python Guide
2FastLabs/agent-squad
Map of the agent-squad Python framework for async multi-agent orchestration: which agent, classifier, storage and tool provider to pick, and the pitfalls to avoid.
Code intelligence over repositories Guaardvark has indexed: semantic code search, exact-text search, file listing, PageRank repository map, import dependency graph, reading one class or function…
Install Code
$ npx skills add guaardvark/guaardvark --skill code -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install guaardvark/guaardvark code --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/guaardvark/guaardvark.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/code .claude/skills/code && rm -rf skills-srcUse ~/.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/
Install the "code" agent skill from https://github.com/guaardvark/guaardvark/tree/main/.agents/skills/code into .claude/skills/code/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/guaardvark/guaardvark/tree/main/.agents/skills/codeType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add guaardvark/guaardvark --skill code -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install guaardvark/guaardvark code --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/guaardvark/guaardvark.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/code .agents/skills/code && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "code" agent skill from https://github.com/guaardvark/guaardvark/tree/main/.agents/skills/code into .agents/skills/code/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add guaardvark/guaardvark --skill code -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install guaardvark/guaardvark code --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/guaardvark/guaardvark.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/code .cursor/skills/code && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "code" agent skill from https://github.com/guaardvark/guaardvark/tree/main/.agents/skills/code into .cursor/skills/code/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/guaardvark/guaardvark.git --path .agents/skills/code--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add guaardvark/guaardvark --skill code -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install guaardvark/guaardvark code --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/guaardvark/guaardvark.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/code .gemini/skills/code && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "code" agent skill from https://github.com/guaardvark/guaardvark/tree/main/.agents/skills/code into .gemini/skills/code/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install guaardvark/guaardvark codeInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add guaardvark/guaardvark --skill code -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/guaardvark/guaardvark.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/code .github/skills/code && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "code" agent skill from https://github.com/guaardvark/guaardvark/tree/main/.agents/skills/code into .github/skills/code/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add guaardvark/guaardvark --skill code -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install guaardvark/guaardvark code --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/guaardvark/guaardvark.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/code .opencode/skills/code && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "code" agent skill from https://github.com/guaardvark/guaardvark/tree/main/.agents/skills/code into .opencode/skills/code/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
code- GitHub stars
- 255
- Used in
- 1 other repo
- Token cost
- ~559 tokens
- SKILL.md length
- 229 words
- Files
- 1
- Skills in repo
- 15
- Repo updated
- First seen
- Licence
- MIT
At a glance
Code intelligence over repositories Guaardvark has indexed: semantic code search, exact-text search, file listing, PageRank repository map, import dependency graph, reading one class or function…
- Works in 4 steps: list_code_repositories → folder id. → get_repository_map for the shape,… → Read the exact code (read_code /… → …
- The user asks where something is implemented
- SKILL.md covers Pattern and Rules
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Code is an agent skill from guaardvark/guaardvark. Code intelligence over repositories Guaardvark has indexed: semantic code search, exact-text search, file listing, PageRank repository map, import dependency graph, reading one class or function, analysis and generated rewrites, plus the System Mapper and self-improvement status. Use when the user asks where something is implemented, how modules depend on each other, or wants an architecture map of an indexed repo.
Its SKILL.md is about 560 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 AI & LLM Engineering, covering Codebase onboarding. It works with Model Context Protocol and Python. The repository describes itself as: The self-hosted AI studio: local video, image, music, voice, LoRA training, coding swarms, RAG and screen agents on one GPU, driven from the Studio or by your coding agent… The licence is MIT.
When your agent uses it
- The user asks where something is implemented
- How modules depend on each other
- Wants an architecture map of an indexed repo
Example prompts
- “/code”
Requirements
- Python 3
Workflow steps
4 steps, taken from the first numbered list in SKILL.md.
- list_code_repositories → folder id.
- get_repository_map for the shape, search_codebase for the question.
- Read the exact code (read_code / read_ast_node) before answering; quote file and line.
- Edits: make them with your own editor tools in the user's checkout; verify_change afterwards.
What it can do on your machine
Read from SKILL.md and the folder at commit f022ceb. 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
No scripts in the folder and no shell commands in SKILL.md.
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
Code loads about 559 tokens when it runs. Until then it costs about 106 tokens; SKILL.md has 229 words of instructions outside code blocks.
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 guaardvark/guaardvark at commit f022ceb, republished under its MIT licence (© guaardvark). 229 words, ~559 tokens.
Download SKILL.mdSave it as
.claude/skills/code/SKILL.md (or your agent's skills folder).- name
- code
- description
- Code intelligence over repositories Guaardvark has indexed: semantic code search, exact-text search, file listing, PageRank repository map, import dependency graph, reading one class or function, analysis and generated rewrites, plus the System Mapper and self-improvement status. Use when the user asks where something is implemented, how modules depend on each other, or wants an architecture map of an indexed repo.
Code intelligence with Guaardvark (MCP tools)
| tool | use |
|---|---|
list_code_repositories | which folders are marked as repositories (gives the folder id) |
search_codebase | semantic search over the indexed project: "where is thinking enabled per model" |
search_code | case-insensitive regex across files |
list_code_files | directory listing to orient |
read_code | a file, or a line range of it (start_line, end_line); large files come back in pages |
read_ast_node | one class or function by name from a Python file |
get_repository_map | PageRank-ranked architectural map for a folder id |
get_dependency_graph | file-level import graph for a folder id |
analyze_code | structure, patterns, improvement notes for a file |
codegen | a complete modified version of a file from instructions (writes a new file) |
verify_change | confirm text now exists in a file after an edit |
map_codebase | run the System Mapper: stats plus ranked findings |
self_improvement_status | can the self-improvement engine run (lock, flag, already running) |
swarm_status | the coding swarm (see the swarm skill) |
Pattern
list_code_repositories→ folder id.get_repository_mapfor the shape,search_codebasefor the question.- Read the exact code (
read_code/read_ast_node) before answering; quote file and line. - Edits: make them with your own editor tools in the user's checkout;
verify_changeafterwards.
Rules
- These tools read Guaardvark's index, which can lag the working tree; when it matters, read the file from disk too.
map_codebaseandself_improvement_statusare read-only here. Dispatching a fix to the self-improvement engine is done in the Studio, on purpose.
© guaardvark, MIT. 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 .agents/skills/code of guaardvark/guaardvark.
Open the folder on GitHubat commit f022ceb
Used in 1 other repository
We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in guaardvark/guaardvark, which our catalogue first saw on October 7, 2026.
Compare with similar skills
Code 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Code this skillguaardvark/guaardvark | 255 | 1 repos | ~559 | Automated safety check: Pass | MIT | |
| Agent Squad Python Guide2FastLabs/agent-squad | 7.8k | — | ~4.7k | Automated safety check: Pass | Apache-2.0 | |
| VeraVeraTools/vera | 118 | — | ~1.2k | Automated safety check: Pass | MIT | |
| Kitaru Devzenml-io/kitaru | 301 | — | ~2.6k | Automated safety check: Pass | Apache-2.0 | |
| VeraVeraTools/vera | 118 | — | ~825 | Automated safety check: Pass | MIT | |
| Opik Instrumentcomet-ml/opik-mcp | 219 | — | ~2.7k | Automated safety check: Notes | Apache-2.0 |
Similar skills
Vera
VeraTools/vera
Code search over the current repository. An agent skill from VeraTools/vera.
Kitaru Dev
zenml-io/kitaru
Kitaru just recipes, CLI structure and structured-output contract, analytics events, and PR-description conventions.
Vera
VeraTools/vera
Code search over the current repository. An agent skill from VeraTools/vera.
Opik Instrument
comet-ml/opik-mcp
Add Opik tracing to an existing app and verify a real trace lands.
Strands
strands-agents/harness-sdk
Build, extend, evaluate, or migrate applications with Strands Agents in Python or TypeScript.
More from guaardvark/guaardvark
All 15 skills in this repoSetup
guaardvark/guaardvark
Connect this agent to a running Guaardvark (self-hosted AI studio) and check what it can do right now.
Voice
guaardvark/guaardvark
Narration and text-to-speech on the user's machine through Guaardvark's Audio Foundry (Chatterbox, Kokoro, Piper) and consent-gated voice cloning from a reference clip.
Cast
guaardvark/guaardvark
Build consistent characters, environments and props in Guaardvark's Cast Library and train LoRAs for them locally (reference photos → vision bible → sample plan → approved samples → training).
Image
guaardvark/guaardvark
Generate or edit images on the user's own GPU through Guaardvark: single images, instruction edits, background cut-outs, inpaint and outpaint, consistent characters from the Cast Library, and batch…
Music
guaardvark/guaardvark
Generate full songs with vocals or instrumentals (ACE-Step) and sound effects or ambience (Stable Audio Open) on the user's GPU through Guaardvark's Audio Foundry.
Ops
guaardvark/guaardvark
Operate a running Guaardvark: GPU and VRAM state, plugin start/stop, logs, Celery tasks, the Interconnector sync to other machines, overnight RAG autoresearch, and infographics.
Related
Works with
Questions about Code
What does Code do?
Code intelligence over repositories Guaardvark has indexed: semantic code search, exact-text search, file listing, PageRank repository map, import dependency graph, reading one class or function…. Code is an agent skill from guaardvark/guaardvark. Code intelligence over repositories Guaardvark has indexed: semantic code search, exact-text search, file listing, PageRank repository map, import dependency graph, reading one class or function, analysis and generated rewrites, plus the System Mapper and self-improvement status.
When should I use Code?
Code fits situations like: the user asks where something is implemented; how modules depend on each other; wants an architecture map of an indexed repo.
How do I install Code in Claude Code?
Run `npx skills add guaardvark/guaardvark --skill code -a claude-code`. Or copy the skill folder (.agents/skills/code in guaardvark/guaardvark) into .claude/skills/code in your project. Claude Code loads it when a task matches its description.
How do I install Code in Codex?
Run `npx skills add guaardvark/guaardvark --skill code -a codex`. Or copy the skill folder (.agents/skills/code in guaardvark/guaardvark) into .agents/skills/code in your project. Codex loads it when a task matches its description.
Can I use Code 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 guaardvark/guaardvark --skill code -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/code, .gemini/skills/code, .github/skills/code and .opencode/skills/code in your project.
What does Code need to run?
SKILL.md names no scripts, command-line tools or credentials: Code is instructions for the agent only. Our summary lists: Python 3.
Does Code 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 Code 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 Code use?
Code is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Code use?
About 559 tokens (SKILL.md is roughly 2.2k 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 Code?
Skills that share tags, products or a category with Code: Agent Squad Python Guide (2FastLabs/agent-squad, 7.8k stars), Vera (VeraTools/vera, 118 stars), Kitaru Dev (zenml-io/kitaru, 301 stars) and Vera (VeraTools/vera, 118 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Code?
guaardvark (a GitHub user) maintains it in guaardvark/guaardvark, which has 255 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 7, 2026.
Source: guaardvark/guaardvark on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.