matilha-scout

matilha-scout is a skill for Claude Code, Codex from danilods/matilha-skills. It costs 34 tokens per session (831 once invoked), scanned B, original, MIT.

A feature-discovery workflow that researches a proposed software feature before its requirements are written. It runs separate investigations into areas such as users, competitors, technology, markets, and regulations when relevant.

In plain words
What is it for?
Use it at the discovery stage of a feature to produce a research document covering user needs, competitors, market context, technical choices, and relevant regulations.
Why use it?
It reduces the risk of writing a feature plan without first understanding the problem, alternatives, or constraints. Its findings are saved as research for a later planning step.

Skill for Claude CodeCodex

Written for Claude Code and Codex: shipped in a Claude Code plugin, but also reads ~/.codex or $CODEX_HOME. Also seen: mentions subagents; mentions Codex.

Part of the matilha plugin — 12 skills, 10 commands, 2 agents, 1 hook shipped together

Good fit Use it at the discovery stage of a feature to produce a research document covering user needs, competitors, market context, technical choices, and relevant regulations.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/danilods/matilha-skills/matilha-scout
Install

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.

Any agent
npx skills add danilods/matilha-skills --skill matilha-scout
Clone the repo
git clone --depth 1 https://github.com/danilods/matilha-skills

Made for: Claude Code, Codex.

Or install matilha, the plugin that ships this one along with the rest of its 12 skills, 10 commands, 2 agents, 1 hook.

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 matilha-scout

README.md
[![agentmods](https://agentmods.dev/badge/skills/danilods/matilha-skills/matilha-scout/github.svg)](https://agentmods.dev/skills/danilods/matilha-skills/matilha-scout)
Your own site
<a href="https://agentmods.dev/skills/danilods/matilha-skills/matilha-scout"><img src="https://agentmods.dev/badge/skills/danilods/matilha-skills/matilha-scout/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.

agentmods 80×15 button for matilha-scout

Your own site · 80×15
<a href="https://agentmods.dev/skills/danilods/matilha-skills/matilha-scout"><img src="https://agentmods.dev/badge/skills/danilods/matilha-skills/matilha-scout.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 34 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 831 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. A grade says what 26 rules found in the file — not that it is safe.
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.00034 $0.00831
Opus 5 $0.00017 $0.00415
Sonnet 5 $0.00007 $0.00166
Haiku 4.5 $0.00003 $0.00083

Measured 11d ago against content hash 95a5ddef9365, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade B, and why

matilha-scout scanned grade B with 1 finding 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 11d 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.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

- **"subagent dispatch fails"**: Check Task tool availability (Codex requires `multi_agent = true` in `~/.codex/config.toml`).
skills/matilha-scout/SKILL.md · 76 lines

How it starts

The opening of the file, as written. The whole thing — 76 lines — stays where its author put it; the contents beside it link to each section on GitHub.

When this fires

User wants to explore a feature's problem space before writing a spec. project-status.md shows current_phase: 0 or 10. The skill dispatches research subagents (market, user needs, competitive, technical, regulatory if relevant) in parallel and synthesizes their output.

Preconditions

  • Feature slug provided (or inferable from prompt).
  • matilha-scout lazy-bootstraps project structure; project-status.md is created if absent.

Execution Workflow

  1. Lazy bootstrap: Ensure docs/matilha/research/ exists (mkdir -p). If project-status.md missing, write a minimal stub (current_phase: 0, phase_status: in_progress, project_slug: <from cwd or prompt>, next_action: "matilha-scout running"). Read project-status.md; verify current_phase ≤ 10 (if present and higher, warn user — scout is Phase 10 territory).
  2. Dispatch 3-5 research subagents via Task tool IN PARALLEL (one Task call per scope: market analysis, user-needs mapping, competitive landscape, technical options, regulatory if applicable).
  3. Wait for all subagents to complete.
  4. Synthesize outputs into docs/matilha/research/<slug>-research.md with sections per subagent + a "Key findings" synthesis at the end.
  5. Update project-status.md: current_phase: 10, phase_status: in_progress, next_action: "Run matilha-plan to write spec + plan".

Rules: Do

  • Use parallel subagent dispatch (multiple Task tool calls in a single message).
  • Cite sources in research output.
  • Separate findings from recommendations.
  • Update project-status on success only.

Rules: Don't

  • Write the spec yourself (that's matilha-plan).
  • Recommend decisions (research surfaces options, user decides).
  • Advance current_phase past 10.

Expected Behavior

Output is a 500-1500 word markdown with structured sections. User reads it, forms a mental model, then invokes matilha-plan. If research surfaces blockers, log them in project-status.md:pending_decisions.

Quality Gates

  • Research output exists and is non-empty.
  • project-status.md shows current_phase: 10.
  • pending_decisions populated if blockers found.

Read the full file on GitHub · 76 lines

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. 11d ago First seen · 76 lines · 34 tokens per session scan B 95a5ddef9365

Subscribe to this mod's changes

matilha-scout is a skill published in the GitHub repository danilods/matilha-skills (2 stars, last pushed 4mo ago), licensed MIT. It adds 34 tokens to every session and 831 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

skill-dev

Use this skill when creating or refining Claude Code skill definitions. Skills are model-invoked capabilities that Claude activates autonomously based on context. Helps design focused skills with discovery-optimized descriptions, proper directory structures, and supporting resources. Automatically invoked when user…

andisab/swe-marketplace · 86 tokens

command-dev

Use this skill when creating or refining custom Claude Code slash commands. Slash commands are user-invoked reusable prompts that can accept arguments, reference files, and execute bash operations. Helps design command syntax, argument handling, file references, bash execution, and frontmatter configuration.…

andisab/swe-marketplace · 85 tokens

plugin-dev

Use this skill when creating or refining Claude Code plugins. Plugins are bundled collections of agents, skills, commands, hooks, and MCP servers that provide cohesive functionality. Helps design proper directory structures, plugin.json configuration, marketplace distribution, and installation workflows. Automatically…

andisab/swe-marketplace · 76 tokens

agent-dev

Use this skill when creating or refining Claude Code sub-agent definitions. Helps design specialized AI assistants with proper YAML frontmatter, system prompts, tool access, and example-driven descriptions. Automatically invoked when user requests "create an agent", "design a sub-agent", "make a specialist", or…

andisab/swe-marketplace · 86 tokens

mcp-server-dev

Create MCP servers — multi-tool services exposed via Model Context Protocol. Use this skill whenever users mention MCP servers, building servers, server scaffolding, tool registration, or want to package tools for distribution via uvx or npx. Also use when the conversation involves stdio transport, server lifecycle…

andisab/swe-marketplace · 175 tokens

mcp-tool-dev

Create MCP tools — individual tool functions exposed via Model Context Protocol. Use this skill whenever users mention MCP tools, tool handlers, tool functions, tool definitions, or want to add capabilities to an MCP server. Also use when the conversation involves designing tool schemas, writing tool descriptions, or…

andisab/swe-marketplace · 158 tokens