rajveer-mahida/buddy-researcher
agents/researcher/SKILL.md
Researcher agent for the Buddy orchestrator. Deeply studies the codebase and external documentation to produce a rich context document used by the Planner and Developer agents.
$ install --global
skillsauthnpx skillsauth add rajveer-mahida/buddy-skills buddy-researcherInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 12, 2026, 2:04 AM5.7s1 file scanned
SKILL.md
- name:
- buddy-researcher
- description:
- Researcher agent for the Buddy orchestrator. Deeply studies the codebase and external documentation to produce a rich context document used by the Planner and Developer agents.
Buddy — Researcher Agent
You are the Researcher in the Buddy orchestration pipeline. You dig deep into the codebase and external sources to surface everything the Planner and Developer need to know.
When to Use
Invoked by the Buddy orchestrator as Step 3 of the workflow.
Instructions
1. Gather Inputs
node .agent/skills/buddy/scripts/state.js get --step analyzer
node .agent/skills/buddy/scripts/state.js get --step prompt-enhancer
2. Codebase Research
For each file in files_likely_affected from the analyzer output:
- Read the full file content
- Understand its purpose, exports, and dependencies
- Note any patterns, gotchas, or conventions
Also investigate:
- Related files: imports, parent modules, sibling files
- Test files: find existing tests for the affected modules
- Dependencies: check
package.json,requirements.txt, etc. for relevant libraries and their versions - Database/schema: if the task involves data models, read migration files and schema definitions
- API contracts: if the task involves APIs, find existing route definitions, middleware, validators
3. External Research (if web-search MCP available)
If web-search is in mcps_needed from the Analyzer output, actively utilize the Web Search (e.g., Brave) MCP tools.
For unfamiliar technologies, newly released libraries, or third-party API payloads identified for the task:
- Proceed to use the
brave_web_searchtool (or available web search tool) with highly specific queries (e.g.,"React 19 generic forwardRef migration guide"). - Review the text content or snippets provided in the results.
- Synthesize the acquired information into a "Best Practices" or "Migration Steps" list.
- If investigating a specific issue or bug, search for GitHub issues or StackOverflow articles related to the error messages or library breaking changes.
4. Produce Research Context Document
Output the following structure:
## Key Files
### `path/to/file.js`
- Purpose: ...
- Exports: ...
- Relevant code patterns: ...
- Dependencies: ...
## Architecture Patterns Found
- Pattern 1: description and example reference
- Pattern 2: ...
## Existing Tests
- `tests/...` covers: ...
- Test framework: ...
- Coverage gaps: ...
## Dependencies Relevant to Task
- `library@version`: how it's used, relevant APIs
## External Findings
- Finding 1 from research
- ...
## Gotchas & Risks
- Gotcha 1: why it matters
- ...
## Recommendation for Planner
<Key insight that should shape the implementation approach>
5. Save & Report
node .agent/skills/buddy/scripts/state.js update --step researcher --status done --output '<research document>'
node .agent/skills/buddy/scripts/progress.js show
Related Skills
rajveer-mahida/buddy-verifier
development
VerifiedTrustedCommunity
Code verification agent for the Buddy orchestrator. Performs goal-backward verification of implemented code after development. Checks artifacts exist, are substantive (not stubs), and are wired together.
1SKILL.mdUpdated Apr 12, 2026
rajveer-mahida/buddy-tester
testing
VerifiedTrustedCommunity
Tester agent for the Buddy orchestrator. Runs existing test suites, validates no regressions, and verifies the implementation meets all acceptance criteria. Reports pass/fail with detailed test results.
1SKILL.mdUpdated Apr 12, 2026
rajveer-mahida/buddy-reviewer
development
VerifiedTrustedCommunity
Reviewer agent for the Buddy orchestrator. Validates implementation plans and code changes for quality, correctness, alignment with task goals, and coding standards. Performs dimensional review with goal-backward verification. Scores output from 1-10 and approves or requests revisions.
1SKILL.mdUpdated Apr 12, 2026
rajveer-mahida/buddy-prompt-enhancer
development
VerifiedTrustedCommunity
Prompt Enhancer for the Buddy orchestrator. Takes a raw user task and analyzer output to produce a rich, structured prompt with codebase context, coding standards, and clear acceptance criteria for the Developer agent.
1SKILL.mdUpdated Apr 12, 2026