agentleFS
Jamie-BitFlightJamie-BitFlight/claude_skills/.agents/skills/topic-specialist/SKILL.md

topic-specialist

Skill67 starsChanged 52 days agoMITView on GitHub

Research a specific technology, library, system, protocol, or tool to answer a concrete technical question with source-traceable evidence. Use when current implementation details, version behavior, configuration, compatibility, or authoritative technical facts must be verified rather than recalled. Also use when explicitly asked to incorporate verified findings into an existing skill.

The file

Show its rules and text

We split this skill into the rules it gives an agent

18 rules. About 0 are common, 18 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈18

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If the user identifies relevant skills or repository guidance, read them as domain context.

    line 21
  2. Distinctive:

    Prefer evidence according to the claim:

    line 27
  3. Distinctive:

    Use secondary sources for discovery, comparison, or when primary evidence is unavailable.

    line 38
  4. Distinctive:

    Keep the researched revision/version and environment explicit when they bound the finding.

    line 40
  5. Distinctive:

    Read or execute the strongest practical source.

    line 47
  6. Distinctive:

    Test the counter-hypothesis with an independent evidence path where practical.

    line 61
  7. Distinctive:

    Do not add a second source merely to satisfy a count.

    line 64
  8. Distinctive:

    When the user explicitly asks to persist the findings into an existing skill:

    line 80
  9. Distinctive:

    Read the complete target skill and its applicable governance.

    line 82
  10. Distinctive:

    Update the narrowest authoritative location.

    line 84
  11. Distinctive:

    Prefer durable rules and runtime discovery over cached version facts that will become stale.

    line 85
  12. Distinctive:

    Run the target repository's required validation.

    line 87
  13. Distinctive:

    Do not claim verification from training-data recall.

    line 93
  14. Distinctive:

    Do not require primary-source code inspection when an authoritative specification already resolves the claim.

    line 94
  15. Distinctive:

    Do not treat README prose as stronger than contradictory version-pinned implementation evidence for implementation behavior.

    line 95
  16. Distinctive:

    Do not infer author intent from implementation alone.

    line 96
  17. Distinctive:

    Do not mutate files unless the user requested a persistent update.

    line 97
  18. Distinctive:

    Do not manufacture certainty when relevant evidence is inaccessible or contradictory.

    line 98

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Topic Specialist

Answer the user's concrete technical question from evidence strong enough for the claim being made. Treat training-data recall as a hypothesis generator, not evidence.

Resolve the research contract

Before researching, identify:

  • topic — the technology, library, system, protocol, or tool;
  • question — the decision or fact to resolve;
  • conditions — version, platform, configuration, environment, or other constraints that could change the answer;
  • deliverable — answer only, or an explicitly requested update to an existing skill.

Infer these from the request when unambiguous. Ask only for missing information that could materially change the research result.

If the user identifies relevant skills or repository guidance, read them as domain context. Treat their factual claims as leads unless their authority independently establishes the claim.

Research

Choose the cheapest evidence capable of resolving the question. Do not mechanically inspect a repository README, entry point, and issue tracker when those sources cannot affect the answer.

Prefer evidence according to the claim:

ClaimStrong evidence
Public API/configuration contractCurrent official documentation/specification
Actual implementation behaviorVersion-pinned source code and tests
Version/release behaviorRelease notes/changelog plus version-pinned implementation when needed
Known defect or maintainer intentMaintainer issue/discussion linked to the affected version
Runtime/environment behaviorReproducible execution in the relevant environment
Historical rationalePrimary design/issue/commit evidence when available

Use secondary sources for discovery, comparison, or when primary evidence is unavailable. Label the limitation rather than presenting weaker evidence as primary.

Keep the researched revision/version and environment explicit when they bound the finding.

Build claim evidence

For each material conclusion:

  1. Identify what observation would support or falsify it.
  2. Read or execute the strongest practical source.
  3. Record the source location and relevant version/date.
  4. Distinguish what the source directly establishes from what is derived from it.
  5. Preserve contradictory evidence instead of silently choosing the preferred source.

Quote only the minimum text needed when exact wording matters. Prefer concise paraphrase plus a precise citation for ordinary factual support.

Challenge consequential findings

Scale verification to consequence and uncertainty.

For a finding that could materially change implementation, compatibility, security, data integrity, or architecture:

  1. Form at least one plausible counter-hypothesis: version difference, feature flag, platform branch, configuration override, wrapper behavior, or stale documentation.
  2. Test the counter-hypothesis with an independent evidence path where practical.
  3. Narrow or revise the conclusion when the counterexample survives.

Do not add a second source merely to satisfy a count. Independent evidence is useful only when it can discriminate between competing explanations.

Produce the answer

State:

  • the verified answer/options;
  • conditions under which each applies;
  • evidence supporting material claims;
  • contradictions or version/environment boundaries;
  • unresolved gaps that could change the answer.

Make a recommendation only when the user's conditions and evidence distinguish among the options. Keep descriptive facts separate from judgment.

Update an existing skill only when requested

When the user explicitly asks to persist the findings into an existing skill:

  1. Read the complete target skill and its applicable governance.
  2. Define the behavior the update must add or correct and the behavior that must remain unchanged.
  3. Update the narrowest authoritative location; do not append a second copy of an existing meaning.
  4. Prefer durable rules and runtime discovery over cached version facts that will become stale.
  5. Cite external facts where the target's citation rules require it.
  6. Run the target repository's required validation.

Creating a new skill is a separate skill-authoring task. Route it through the repository's skill-creation process rather than embedding scaffolding procedure here.

Boundaries

  • Do not claim verification from training-data recall.
  • Do not require primary-source code inspection when an authoritative specification already resolves the claim.
  • Do not treat README prose as stronger than contradictory version-pinned implementation evidence for implementation behavior.
  • Do not infer author intent from implementation alone.
  • Do not mutate files unless the user requested a persistent update.
  • Do not manufacture certainty when relevant evidence is inaccessible or contradictory.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

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.