sidebar
Skill1 starsChanged 3 months agoApache-2.0View on GitHub
Answer a tangential side question without bloating the main session - delegate it to a subagent that researches it in its own context (the repo first, reaching out to the web only when the answer isn't in the project) and returns only a tight, cited answer. Use whenever the user asks a side/aside question mid-session, says "sidebar", "side question", "quick aside", "while we're here", "remind me how X works", or wants to look something up about the project's architecture, design, or existing/planned code or infra without spending main-chat context. Prefer this over answering inline so the heavy file-reading stays in the subagent and only the distilled answer returns.
In this repository24 other files it gives its agents.
- audit-fixSkill
- auditSkill
- commitSkill
- deps-auditSkill
- digestSkill
- flowchartSkill
- git-undoSkill
- handoffSkill
- hone-skillSkill
- kickoffSkill
- math-researchSkill
- new-skillSkill
- next-stepsSkill
- prompt-engineerSkill
- prune-test-suiteSkill
- release-notesSkill
- repo-adoptSkill
- repo-issue-scoutSkill
- resolve-tester-bugsSkill
- scaffold-auditSkill
- session-reportSkill
- sync-profile-readmeSkill
- rename-to-match-folderSkill
- worktree-cleanupSkill
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 24
When in doubt, use Explore.
- Distinctive: line 41
If the question is self-contained, skip the orientation line entirely — the subagent already has the repo and working dir.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
sidebar
Answer a side question by delegating it to a subagent, so the research happens in the subagent's context and only a concise answer returns to the main chat. The point is efficiency: spend main-session context on the question and the answer, never on the file-reading in between.
The side question: $ARGUMENTS
1. Pick the subagent
Choose by what the question needs, then dispatch with the Task tool:
Explore(default) — understanding existing code or infra: "how/where does X work", "what does this module do", "where is Y configured". Read-only, search-optimized, reads excerpts not whole files.Plan— design or architecture questions about planned or changing work: "how would I structure X", "what's the right approach for Y", trade-offs. For a mathematical or algorithmic method choice that needs literature citations rather than a judgment call, use/math-researchinstead.general-purpose— cross-cutting or multi-step questions that need both searching and reasoning across several areas.
When in doubt, use Explore. Spawn one subagent — do not fan out for a quick aside.
Dispatch at model: "opus". Pass it explicitly in the Agent call. This skill
exists to keep research off the main session's budget; letting the subagent
inherit a costlier session model defeats the point of delegating at all.
Research the repo first; go external only as a fallback. Tell the subagent to answer from the codebase and project files whenever it can. It may use the web (it has WebSearch/WebFetch) only when the answer genuinely isn't in the project — e.g. external library behavior, a spec, or current best practice — and must then label the externally-sourced claim and cite its URL. For heavyweight, multi-source, fact-checked web research, use /deep-research instead.
2. Build a lightweight context envelope
Give the subagent just enough to answer well, no more. Keep it to a few lines — do NOT paste the conversation or dump files. Include:
- The question, verbatim or lightly sharpened.
- One line of orientation only if it changes the answer — e.g. the project/working dir, or what the main session is currently focused on (e.g. "we're mid-refactor of the auth layer; this is an aside").
- The return contract (below).
If the question is self-contained, skip the orientation line entirely — the subagent already has the repo and working dir.
3. Instruct the subagent to return tightly
Tell the subagent explicitly to:
- Answer the question directly and concisely — a few sentences or a short list, not a report.
- Cite specifics as
path/to/file.ext:lineso the user can click through. - Surface only what's needed to answer; omit exploration narrative, file dumps, and dead ends.
- State plainly if the answer isn't found, rather than padding.
4. Relay the result
Return the subagent's answer to the user, lightly framed if useful (e.g. "Sidebar
answer:"). Keep your own additions minimal — the value is the distilled answer,
not commentary on it. If the answer is incomplete, offer a focused follow-up
sidebar rather than re-investigating inline.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

