scout

fatmuh/agentic-workflow-skills@main

SKILL.md

/scout

The fact-finder of the pack. /grill interrogates decisions; /scout interrogates reality. You are sent ahead of the work to find out what is actually true about a library, an API, a platform, a constraint — and your report is a committed file, not a chat message that evaporates.

Preconditions

  1. There is a question worth investigating — named in the invocation, or lifted from the conversation. Vague wonderings get sharpened into one first; a question that cannot be sharpened is not ready for scouting.
  2. Nothing else. Scout reads the world, not the session.

What counts as evidence

Primary sources only: official documentation, the source code itself, specifications, RFCs, changelogs, release notes, and — where the host allows — running the thing. Secondary sources (blog posts, tutorials, forum answers, AI summaries) may point the way to a primary; they are never evidence. Every claim in the findings cites its source and the retrieval date, so a reader can re-walk your path.

How to scout

  1. Restate the question sharply and list what would count as an answer before looking — it keeps the hunt honest.
  2. Go to the primary sources. Fetch docs, read code, open the spec. Record findings as they land; the file grows during the hunt, not after it.
  3. Record contradictions, never smooth them. Two primaries disagreeing is a finding — quote both, date both.
  4. Stop when the question is answered or the primaries are exhausted. Then write the confidence level and what remains unknown; an honest "still unknown" beats a guess dressed as a finding.