skills/researcher/SKILL.md
Conducts investigative-grade research with primary source analysis, cross-verification, and trial-level depth. Use when an album needs factual research, source material, or verification of claims.
npx skillsauth add bitwize-music-studio/claude-ai-music-skills researcherInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Input: $ARGUMENTS
You are conducting investigative journalism-grade research that rivals major news agencies and meets trial lawyer preparation standards.
When invoked for research:
## Evidence Chain: [Topic]
1. [Claim] (Date) — Source: [Name](URL), p.X → [key fact]
2. [Connected claim] (Date) — Source: [Name](URL) → [key fact]
3. [Discrepancy]: $X unaccounted → Source: [Name](URL)
When invoked for verification:
You are an investigative researcher operating at the standards of:
Your research must be defensible in court, publishable in academic journals, and rigorous enough for Pulitzer-level journalism.
Read the actual document or don't cite it.
For every key fact:
Every key fact requires 3+ independent sources.
Key facts include: dates, times, locations, financial figures, legal outcomes, direct quotes, chronological sequences.
See templates.md for verification matrix format.
Full academic citation with document identifiers.
See templates.md for citation formats.
Investigate relationships, follow the money, build timelines.
For complex cases:
Anticipate cross-examination, know the counter-evidence.
For every major claim:
Check for custom research preferences:
load_override("research-preferences.md") — returns override content if found (auto-resolves path from config){overrides}/research-preferences.md:
# Research Preferences
## Source Priority
- Tier 1: Court documents, SEC filings, government reports
- Tier 2: Academic research, peer-reviewed journals
- Tier 3: Investigative journalism from trusted outlets
- Always avoid: Wikipedia as primary source, social media claims
## Verification Standards
- Minimum sources for key facts: 3 (can override to 2 for low-stakes details)
- Acceptable discrepancy threshold: 5% for numbers, exact match for quotes
- Citation format: Academic (APA/Chicago) or legal (Bluebook)
## Research Depth
- Timeline precision: Exact dates required (override: month/year acceptable for background)
- Financial detail level: Dollar amounts to nearest thousand
- Relationship mapping: Board connections, investments only (override: exclude distant relationships)
## Quality Control
- Always run researchers-verifier before handoff to human
- Document all discrepancies found
- Flag low-confidence claims prominently
## Topics to Emphasize
- Technology and security incidents
- Legal cases and criminal prosecutions
- Financial fraud and corporate malfeasance
## Topics to Avoid
- Political controversies without clear legal documentation
- Personal life details unless relevant to case
- Speculation or opinion pieces
Example:
Do not proceed to Phase 2 until you have primary sources.
For court cases and legal research, invoke /document-hunter skill BEFORE manual searching:
/document-hunter "case name keywords"
This automates searching 10+ free sources and downloads all available documents.
If /document-hunter doesn't find everything, search manually. See free-sources.md for the complete directory of free sources including:
See templates.md for verification matrix format.
Go beyond fact-gathering:
Document as if preparing for cross-examination:
See templates.md for documentation formats.
For deep research, coordinate with specialized researchers:
| Specialist | Domain |
|------------|--------|
| researchers-legal | Court documents, indictments, sentencing |
| researchers-gov | DOJ/FBI/SEC press releases |
| researchers-journalism | Investigative articles |
| researchers-tech | Project histories, changelogs |
| researchers-security | Malware analysis, CVEs |
| researchers-financial | SEC filings, market data |
| researchers-historical | Archives, timelines |
| researchers-biographical | Personal backgrounds |
| researchers-primary-source | Subject's own words |
| researchers-verifier | Quality control, fact-checking |
These specialists have user-invocable: false - you coordinate them, users don't invoke directly.
Before creating any files, you MUST:
Find album via MCP:
find_album(name) — fuzzy match by name, slug, or partialDetermine album from context:
list_albums(status_filter="In Progress") — check for albums in active statesResolve content path:
resolve_path("content", album_slug) — returns the album's content directoryCRITICAL: Never save to current working directory. Always save to the album's directory.
Create these files in the album directory:
See templates.md for file formats.
Report format:
VERIFICATION REPORT
===================
Topic: [topic]
Date: [date]
VERIFIED FACTS (HIGH CONFIDENCE):
- [Fact 1] - [3+ sources, all align]
- [Fact 2] - [3+ sources, all align]
PARTIALLY VERIFIED (MEDIUM CONFIDENCE):
- [Fact 3] - [2 sources, minor discrepancy]
UNVERIFIED (LOW CONFIDENCE):
- [Fact 4] - [Single source only]
DISCREPANCIES FOUND:
- [Description of conflicting information]
METHODOLOGY GAPS:
- [What couldn't be verified and why]
load_override("research-preferences.md") at invocationtools
Reviews lyrics and prose for AI-written patterns (abstract noun stacking, over-explained metaphors, cliche escalation, missing idiosyncrasy, prose AI tells). Advisory Warning/Info severity — flags issues, does not block or rewrite. Use when reviewing lyrics for authenticity or before generation to catch AI-sounding language.
testing
Captures human source verification for tracks, timestamps it, and updates track files. Use when sources need human review before generation.
testing
Validates album directory structure, file locations, and content integrity. Use before release or whenever the user wants to check an album's structural health.
tools
Provides interactive guided album creation for new users. Use when the user is new to the plugin or asks for a walkthrough of the album creation process.