Agent skill

Research

by boshu2 in boshu2/agentops

Answer one cited question: how code works, or whether a repeated pattern deserves a rule.

Apache-2.0Auto-check: notes

Install Research

skills CLI
$ npx skills add boshu2/agentops --skill research -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install boshu2/agentops research --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/boshu2/agentops.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/research .claude/skills/research && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
research
GitHub stars
448
Used in
1 other repo
Token cost
~1.7k tokens
SKILL.md length
707 words
Files
10 (incl. scripts, references)
Skills in repo
31
Repo updated
First seen
Licence
Apache-2.0

At a glance

Answer one cited question: how code works, or whether a repeated pattern deserves a rule.

  • Works in 3 steps: State the question and the decision it… → Inspect the smallest relevant sources… → Lead with the answer, then show evidence…
  • Whether to enforce a pattern
  • SKILL.md covers Evidence rules, Investigation, Repository tracing and Pattern evidence, plus 1 more section
  • Runs Shell scripts from its folder

What it does

Research is an agent skill from boshu2/agentops. Answer one cited question: how code works, or whether a repeated pattern deserves a rule. Use when: asked how, why, or whether to enforce a pattern.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 16 other files, including scripts and reference files (for example `references/codebase-recon/pack-contract.md`, `references/pattern-mining/pack-contract.md` and `schemas/findings.json`).

The repository describes itself as: DevOps discipline for AI coding agents: shape the work, track it as a graph, and get each change judged by a context that didn't write it. The licence is Apache-2.0.

When your agent uses it

  • Whether to enforce a pattern

Example prompts

  • “/research”

Requirements

  • A Bash shell
  • Pre-approved tools (allowed-tools): Read, Grep, Glob, Bash, Write

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. State the question and the decision it informs. Reuse the accepted scope and
  2. Inspect the smallest relevant sources and verify search hits against the
  3. Lead with the answer, then show evidence and remaining gaps. Each part of the

What it can do on your machine

Read from SKILL.md and the folder at commit 8704853. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Grep
    • Glob
    • Bash
    • Write

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Shell), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Research loads about 1.7k tokens when it runs, and up to ~3.4k if it reads all its reference files. Until then it costs about 39 tokens; SKILL.md has 707 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~39
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Grep, Glob, Bash, Write

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from boshu2/agentops at commit 8704853, republished under its Apache-2.0 licence (© boshu2). 707 words, ~1,653 tokens.

Download SKILL.mdSave it as .claude/skills/research/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
research
description
Answer one cited question: how code works, or whether a repeated pattern deserves a rule. Use when: asked how, why, or whether to enforce a pattern.
allowed-tools
Read, Grep, Glob, Bash, Write
practices
pragmatic-programmer, ddd-bounded-context
hexagonal_role
driving-adapter
consumes
research-question
produces
research-report, codebase-recon.v1, pattern-mining.v1
skill_api_version
1
user-invocable
true
metadata.capabilities
research, codebase_recon, pattern_mining
metadata.effects
write_research_report, write_recon_pack, write_pattern_evidence
metadata.canonical_status
canonical
metadata.disposition
keep_specialist

Research

Answer the caller's bounded question with cited evidence. Choose ordinary investigation, repository tracing or pattern evidence according to the question; these are optional modes, not a sequence. A quick answer needs no report file. Plan owns unified discovery and resumption when the question is part of shaping a change; return this cited answer to that existing intent without restarting its interview or taking over caller choices.

Evidence rules

  • One lineage counts once. Copies, ports and repeated quotations of one upstream source are a single exemplar, however many files or reports carry them. Check provenance before counting instances as independent.
  • Separate the invariant from the incidental. Align instances by their role in the behavior; name what must hold, what legitimately varies and what is incidental syntax. An instance missing the invariant is not an instance.
  • Recurrence does not earn a gate. A blocking check needs a demonstrated cost of violation: an incident, defect or measured harm traced to the pattern's absence. Recommend the least committed useful shape: no action, a reference or checklist line, a template, a helper, and only then a gate.
  • Thin evidence stays a hypothesis. Fewer than three independent exemplars, or no passing holdout, leaves a pattern a hypothesis; say what evidence would confirm or refute it.
  • Keep observation, inference, contradiction and unknown separate. Every material claim cites evidence; source agreement does not erase shared provenance.

Investigation

  1. State the question and the decision it informs. Reuse the accepted scope and identify what evidence would answer it; do not expand the objective mid-search.
  2. Inspect the smallest relevant sources and verify search hits against the actual source. External facts that change (versions, vendor behavior, standards) need current primary sources. This skill pre-approves only local tools: use the host's web tools when available and permitted; otherwise mark the external claim unknown and name the source that would settle it.
  3. Lead with the answer, then show evidence and remaining gaps. Each part of the question is answered or explicitly unknown with the searched scope disclosed.

Code claims cite the observed commit plus file:line. For uncommitted content, state HEAD and the changed-file status; do not claim the working bytes can be replayed from HEAD. Keep source identity and freshness visible. Search output, CASS, MS and prior reports are leads, not authority or required phases. Use the current agent by default; additional readers and runtimes require caller selection or existing authorization.

For several supplied reports, retain each source's identifier, author/runtime when known and revision/date. Compare claims as agreement, contradiction or unknown while preserving their original evidence. Verify decisive claims at their source and return one synthesis; do not launch recursive synthesis passes.

Show full SKILL.md (265 more words)Show less

Repository tracing

For a repository model or audit, start from its declared entry points in docs, build manifests or command help and verify them against executable paths. Follow a relevant flow through entry, domain logic, integration and tests; prefer a completed trace to a shallow directory inventory. Report an interrupted trace at its exact file/line and explain what is missing. Choose a useful lens such as persistence, authorization, CLI, build or test without requiring a sweep of every lens.

An inline investigation may use dirty working-tree evidence with explicit limits. A selected durable codebase-recon.v1 pack is commit-bound and follows the recon pack contract, checked by skills/research/scripts/codebase-recon/validate-output.sh.

Pattern evidence

For a recurring implementation shape, test whether the similarity represents a reusable rule under the evidence rules above. Record replayable searches, examined hits and exclusions, then report:

text
exemplars: <file:line> per independent lineage; copies listed under their source
invariant: <what every exemplar shares and the behavior needs>
variation: <legitimate differences>; incidental: <syntax, names>
cost:      <demonstrated cost of violation, or "none found">
shape:     <no action | reference line | template | helper | gate> and why
outcome:   hypothesis | promote (three independent exemplars, passing holdout and back-application)

A selected durable pattern-mining.v1 record follows the pattern pack contract, checked by skills/research/scripts/pattern-mining/validate-output.sh. Research returns evidence; adoption remains an explicit caller decision.

Output and boundaries

Return a cited answer directly unless a durable output was requested or the selected evidence contract requires one. Ordinary durable reports follow findings.json: question, scope, answer, evidence, contradictions, unknowns, checked and unchecked areas. Multi-report synthesis also retains source_ledger and comparison. Selected recon and pattern modes retain their own validated formats instead of forcing them into this schema.

Use only authorized sources and destinations. For restricted or mined episode material, follow Memory's access and storage boundary. Research selects no work, owns no merged context store, mutates no lifecycle state and issues no semantic verdict. The native caller owns implementation, judgment and completion of the authorized outcome.

© boshu2, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 9 other files (scripts, references) in skills/research of boshu2/agentops.

  • SKILL.md
  • references/codebase-recon/codebase-recon.feature
  • references/codebase-recon/pack-contract.md
  • references/pattern-mining/pack-contract.md
  • references/pattern-mining/pattern-mining.feature
  • references/research.feature
  • schemas/findings.json
  • scripts/codebase-recon/validate-output.sh
  • scripts/pattern-mining/validate-output.sh
  • scripts/validate.sh

Open the folder on GitHubat commit 8704853

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in boshu2/agentops, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Research next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Research compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Research this skillboshu2/agentops4481 repos~1.7kAutomated safety check: NotesApache-2.0
Answer Ads Questionsgooseworks-ai/goose-skills1.2k—~3.1kAutomated safety check: PassMIT
Find And Citeoutline/outline41k—~537Automated safety check: PassCustom licence
Logseq Answer Machinelogseq/logseq45k—~1.2kAutomated safety check: WarnAGPL-3.0
Citebrycewang-stanford/Auto-Empirical-Research-Skills4.5k—~480Automated safety check: NotesCustom licence
Answering Research Questionswentorai/Research-Claw858—~4.9kAutomated safety check: PassCustom licence

Similar skills

  • Answer Ads Questions

    gooseworks-ai/goose-skills

    Answer questions about a brand's Meta ads (spend, results, which ad is winning, is it paused, why did Goose do that) only from reads made in the same turn, with the data window and sync time on…

    1.2k GitHub stars~3.1k tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • Find And Cite

    outline/outline

    Answer questions from the Outline knowledge base with quotes and links to the source documents; use when the user asks what the team knows, documented, or decided about a topic.

    41k GitHub stars~537 tokensUpdated yesterday
    Knowledge ManagementAuto-check passed
  • Answer user questions about the Logseq repository by researching source code, docs, tests, runtime behavior, and local tools.

    45k GitHub stars~1.2k tokensUpdated today
    Knowledge ManagementAuto-check: warnings
  • Cite

    brycewang-stanford/Auto-Empirical-Research-Skills

    Finds a paper by title, author, or DOI, adds BibTeX to references.bib, and shows citation syntax.

    4.5k GitHub stars~480 tokensUpdated 4 days ago
    Research & ScienceAuto-check: notes
  • Answering Research Questions

    wentorai/Research-Claw

    Main orchestration workflow for systematic literature research - search, evaluate, traverse, synthesize via the rp tools pipeline (Scopus + OpenAlex)

    858 GitHub stars~4.9k tokensUpdated 1 mo ago
    Research & ScienceAuto-check passed
  • Visual Answer

    BuilderIO/agent-native

    Answer code/product questions as visual Plan artifacts using repo, bridge, or GitHub context; use for API specs, UI look, schema models, and architecture.

    7.1k GitHub stars~950 tokensUpdated today
    Backend & APIsAuto-check passed

More from boshu2/agentops

All 31 skills in this repo
  • Agent Native

    boshu2/agentops

    Dispatch independent tasks to parallel workers or subagents without write collisions.

    448 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • Council

    boshu2/agentops

    Compare independent opinions from several models or contexts without inflating agreement.

    448 GitHub starsUsed in 1 repo~3k tokens
    Auto-check passed
  • Craft Goal

    boshu2/agentops

    Draft or lint a bounded long-running goal prompt with a finish line and hard limits.

    448 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed
  • Doc

    boshu2/agentops

    Write or update READMEs, docs, repo instructions and handoff notes, checked against source.

    448 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • Idea Genie

    boshu2/agentops

    Brainstorm evidence-backed options for what to build, or stress-test an idea.

    448 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Implement

    boshu2/agentops

    Change or repair code, config or services without weakening tests; report what ran and what did not.

    448 GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed

Questions about Research

What does Research do?

Answer one cited question: how code works, or whether a repeated pattern deserves a rule. Research is an agent skill from boshu2/agentops. Answer one cited question: how code works, or whether a repeated pattern deserves a rule.

When should I use Research?

Research fits situations like: whether to enforce a pattern.

How do I install Research in Claude Code?

Run `npx skills add boshu2/agentops --skill research -a claude-code`. Or copy the skill folder (skills/research in boshu2/agentops) into .claude/skills/research in your project. Claude Code loads it when a task matches its description.

How do I install Research in Codex?

Run `npx skills add boshu2/agentops --skill research -a codex`. Or copy the skill folder (skills/research in boshu2/agentops) into .agents/skills/research in your project. Codex loads it when a task matches its description.

Can I use Research in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add boshu2/agentops --skill research -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/research, .gemini/skills/research, .github/skills/research and .opencode/skills/research in your project.

What does Research need to run?

Going by SKILL.md and its folder, Research needs a shell for the scripts in its folder. Our summary lists: A Bash shell. Its frontmatter pre-approves these tools: Read, Grep, Glob, Bash, Write.

Does Research access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Research safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Research use?

Research is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Research use?

About 1.7k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.7k tokens, read only when the agent opens those files.

What are the alternatives to Research?

Skills that share tags, products or a category with Research: Answer Ads Questions (gooseworks-ai/goose-skills, 1.2k stars), Find And Cite (outline/outline, 41k stars), Logseq Answer Machine (logseq/logseq, 45k stars) and Cite (brycewang-stanford/Auto-Empirical-Research-Skills, 4.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Research?

boshu2 (a GitHub user) maintains it in boshu2/agentops, which has 448 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on October 9, 2026.

Source: boshu2/agentops on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.