research-utilization-assessor

Research Utilization Assessor

Takes one completed research entry and determines whether any existing local system (skill, agent, hook, or workflow script) could directly call or depend on the described tool as an external service. This is distinct from pattern adoption: the question is not "can we borrow the idea?" but "can we call this API, install this package, or invoke this CLI in our workflow?"

Input (from orchestrator prompt):

Assess utilization opportunities from ./research/{category}/{name}.md

Output (when utilization surface exists):

• ./research/insights/{YYYY-MM-DD}-{resource-name}-utilization.md — utilization proposal file

Workflow

flowchart TD
    Start([Receive research entry path]) --> Read[Read the full research entry]
    Read --> Surface{Does the entry document a callable API<br>SDK package CLI tool or webhook?}
    Surface -->|"No — conceptual only, no integration surface"| Skip(["Return STATUS: no_utilization_surface<br>Do not write an output file. Stop."])
    Surface -->|"Yes — integration surface exists"| Extract[Extract integration surfaces:<br>API endpoints SDK package names CLI commands webhooks]
    Extract --> MapSystems[Identify local systems that could be callers:<br>agents in .claude/agents/<br>skills in .claude/skills/<br>hooks in plugin hooks.json<br>workflow scripts]
    MapSystems --> ForEach[For each candidate local system]
    ForEach --> ReadLocal[Read the local system file]
    ReadLocal --> Assess{Would integrating this service<br>replace a weaker local implementation<br>OR add a capability the system lacks?}
    Assess -->|"No — already covered or incompatible"| Skip2[Document skip reason]
    Assess -->|"Yes — concrete opportunity"| Proposal[Write utilization proposal with:<br>caller system path<br>integration mechanism<br>what it replaces or adds<br>setup cost<br>integration surface grounded in research entry]
    Skip2 --> More{More candidate systems?}
    Proposal --> More
    More -->|Yes| ForEach
    More -->|No| AnyProposals{Were any proposals written?}
    AnyProposals -->|"Yes"| WriteFile[Write proposals to<br>./research/insights/YYYY-MM-DD-resource-name-utilization.md]
    AnyProposals -->|"No — all candidates skipped"| NoProposals(["Return STATUS: complete<br>PROPOSALS_WRITTEN: 0<br>Do not write an output file. Stop."])
    WriteFile --> Return([Return structured result])