brownfield
Scan and manage brownfield repository/worktree defaults for interviews
Install / Use
npx skills add Q00/ouroboros --skill brownfieldInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of brownfield
brownfield scores 92/100 on our quality scale, 802nd of 4,698 Development & Engineering skills we index (top 18%).
Its SKILL.md is 7.1 KB long, well organised into 8 sections with 5 code examples: a thorough specification that gives an agent plenty to work with.
With 6,368 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 3 days ago, so brownfield is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-16. Automated pattern scan on 2026-11-16. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
brownfield compared with similar skills
All 4 of these similar skills score higher than brownfield; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| brownfield (this skill)by Q00 | 92 | 6.4k | 3d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
Frequently asked questions
- How do I install brownfield?
- Run
npx skills add Q00/ouroboros --skill brownfield. The install tabs above show the steps for each supported agent. - Which AI agents does brownfield work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is brownfield safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is brownfield still maintained?
- The repository was last updated 3 days ago, so brownfield is actively maintained.
Skill content
View source on GitHubname: brownfield description: "Scan and manage brownfield repository/worktree defaults for interviews"
/ouroboros:brownfield
Manage the registry of existing git repositories and linked worktrees, and the default repos used as interview context. The registry lives in the Ouroboros DB: listing, defaults, and search read it and never walk the filesystem. Only scan walks the disk.
ooo brownfield # List registered repos and set defaults (scans only if none are registered)
ooo brownfield scan # Rescan the scan root and refresh the search index
ooo brownfield defaults # Show current defaults
ooo brownfield find <topic> # Rank registered repos by relevance to a topic
ooo brownfield set 6,18,19 # Set defaults by repo numbers
ooo brownfield detect [path] # Author mechanical.toml via one AI call
Loading MCP tools (deferred-schema guard)
Ouroboros tools may be deferred, and a schema loaded on one turn can unload by the next. Immediately before each ouroboros_* call, load it with the active runtime's tool-discovery capability: "+ouroboros brownfield" for ouroboros_brownfield. A call whose schema is not loaded fails with "Invalid tool parameters". If the tool is already callable, discovery is a no-op and an empty result is expected. If it is genuinely absent, stop and say the Ouroboros MCP server is not available. Listing, scan, find, defaults, and set use only this MCP tool, never the CLI or Python scripts.
Default flow (ooo brownfield)
Step 1: List the registry
Tool: ouroboros_brownfield
Arguments: { "action": "query" }
If meta.total is 0, nothing is registered yet: run the scan below instead and use its response. Otherwise do not scan; the user runs ooo brownfield scan when repos were added or moved.
Tool: ouroboros_brownfield
Arguments: { "action": "scan" }
Scan boundaries:
- The walk starts at
scan_root(default: the user's home directory) and goes at most two directory levels deep (~/repoand~/group/repoare found; deeper nesting is not). - Dot-prefixed and noisy directories such as
node_modulesare not walked. - Normal repos (
.gitdirectory) and linked worktrees (.gitfile) are registered self-only when the walk reaches them. Git worktree families are not expanded, so worktrees outside the depth-bounded walk (e.g. under.ouroboros/worktrees) are not pulled in. - Repos without remotes or with remotes not named
originare eligible. Existing defaults are preserved; repos no longer on disk are not removed. - A rescan skips the
gitcheck for already-registered repos and rebuilds a repo's search document (manifest name and description, README head, top-level entry names) only when those files changed.
The query or scan response text already holds the numbered {id}. {name} list with * markers on defaults (query lines also carry : {path} - {desc}); make no further MCP calls to list repos. Show the numbers and names (never the scores or paths) as a plain-text two-column grid in a code block (not a markdown table), keeping the * markers exactly:
Scan complete. 8 repositories registered.
1. repo-alpha 5. repo-epsilon
2. repo-bravo * 6. repo-foxtrot
3. repo-charlie 7. repo-golf *
4. repo-delta 8. repo-hotel
If the scan finds nothing, say "No git repositories or worktrees found." and stop.
Step 2: Default selection
Do NOT use the active runtime's ask_user dialog for this selection: text between tool calls may not render, and dialog previews truncate long lists. Instead, end the turn with the repo grid as the final message and collect the selection as a plain chat reply. Directly below the grid, append:
- With defaults:
Current defaults: <names> (numbers <numbers>), then "Reply with repo numbers to change defaults (e.g. "6, 18, 19"), "keep" to keep the current defaults, or "none" to clear them." - Without defaults:
No defaults set., then "Reply with repo numbers to set defaults (e.g. "6, 18, 19"), or "none" to run interviews in greenfield mode."
Make no tool calls after the grid; the breadcrumb footer is still the last line.
Next turn, parse the reply: numbers (any separator) → those indices; "keep" → confirm defaults unchanged, no MCP call; "none" → empty indices; anything else → ask again in plain text, never guess. Then update all defaults in one call (it replaces every existing default):
Tool: ouroboros_brownfield
Arguments: { "action": "set_defaults", "indices": "<comma-separated IDs>" }
For example { "action": "set_defaults", "indices": "6,18,19" }, or "indices": "" for "none".
Step 3: Confirm
Name the new defaults and that they will be used as interview context; for "none", say interviews run in greenfield mode and ooo brownfield can set defaults later.
Subcommands
-
scan: run the Step 1 scan call (even when repos are registered); show the grid and stop. -
defaults: run the Step 1 query call (no scan) and show only the*repos, or "No default repos set. Run 'ooo brownfield' to configure." -
find <topic>: rank the registered repos for the topic, without scanning:Tool: ouroboros_brownfield Arguments: { "action": "query", "text": "<topic>" }Show the returned lines best first (number, name,
*marker, score; the top 10 unless the user asks for more, then passlimit) and offerooo brownfield set <numbers>. Ranking is lexical (BM25 over name, description, path, manifest, README head, and top-level entries), so it matches words, not meaning: if nothing matches, say so and suggest other keywords orooo brownfieldfor the full list. When the response says some repos have no search document, mention thatooo brownfield scanindexes them. -
set <indices>: parse the comma-separated indices and call{ "action": "set_defaults", "indices": "<indices>" }without scanning; confirm the updated defaults. -
detect [path]: one AI call against the target directory (default: cwd) writes.ouroboros/mechanical.tomlwith validated lint/build/test/static/coverage commands, which Stage 1 of evaluation reads verbatim. Evaluation auto-runs it when no toml exists, so run it explicitly only to pre-author, refresh after a build-tool change (--force), or review commands before Stage 1 trusts them. This subcommand uses the CLI through the active runtime'srun_shellcapability:uvx --python '>=3.12' --from ouroboros-ai ouroboros detect [path] # or, if already installed: ouroboros detect [path] [--force]Print the resulting toml so the user can confirm or edit it. If detect reports "could not propose any verifiable commands", surface the reason (no manifests, LLM unavailable, every proposal dropped) and suggest a minimal hand-written toml; one entry such as
test = "pytest -q"opts that check back in to Stage 1.
RFC #1392 State Breadcrumb Footer
End the final response with exactly one line ◆ <current state> → next: <recommended action>. Derive the state from live session state via ouroboros_session_status when available, otherwise from this skill's actual outcome. Never use a linear Step N of M footer; when the next step is a real choice, list 2-3 options.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
