Fact Find Skill | Agent Skills

Fact Find

Fast, focused answers to specific factual questions about Bottlerocket with proper citations.

Purpose

Quickly find and cite concrete facts about Bottlerocket:

Configuration values and defaults
Partition schemes and disk layouts
Systemd units and targets
File paths and locations
Version numbers and dependencies

When to Use

Need a specific fact, not an explanation
Question has a concrete, definitive answer
Looking for "what is" or "where is" information

For broader questions about architecture or design, use deep-research instead.

Procedure

1. Search

Create a focused query with key terms:

crumbly search "specific terms from question"

Check top 3-5 results for relevant files.

2. Read

Read the most relevant files to find the answer:

# Pattern search for targeted reading
grep -n "relevant terms" path/to/file.md

# Full file if needed
cat path/to/file.md

3. If Documentation Is Insufficient

Crumbly indexes documentation, not source code. If you can't find the answer in docs, search the codebase directly:

# IMPORTANT: Always scope searches to specific directories!
# The forest is 80GB+ - unscoped searches will hang.
rg "search_term" --type rust bottlerocket/sources/
find bottlerocket/sources -name "*relevant_name*"

This indicates a documentation gap - note it in your Research Quality Indicator.

4. Answer with Citations

Provide a direct, concise answer with inline superscript citations and a Sources section:

Bottlerocket uses a dual partition scheme with sets A and B <sup>[1]</sup>. The default API socket is `/run/api.sock` <sup>[2]</sup>.

## Sources

<sup>[1]</sup> [`sources/updater/signpost/README.md`](../sources/updater/signpost/README.md)
- Partition set structure

<sup>[2]</sup> [`sources/api/README.md`](../sources/api/README.md)
- API socket configuration

Citation guidelines:

Use <sup>[1]</sup>, <sup>[2]</sup>, etc. inline with facts
Paths relative to the target repository
Markdown links for file paths
GitHub URLs for cross-repo references: https://github.com/bottlerocket-os/REPO/blob/develop/FILE.md
Brief bullet points describing what each source provided

Validation

A good fact-find response:

✓ Directly answers the specific question
✓ Concise (2-4 sentences typically)
✓ Superscript citations inline
✓ Sources section with numbered references
✓ No unnecessary context or explanation

Research Quality Indicator

End your response with:

✅ Answered from documentation - Found in README files, design docs, or narrative documentation.
⚠️ Answered from source code - Had to read implementation files due to insufficient documentation.
🔍 Partial documentation - Required both docs and source code to answer fully.

Agent Skills: Fact Find

Skill Files