gap-analysis

Cluster weaknesses from evaluated papers and generate gap reports.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ZhangHanbo/alpha_research --skill gap-analysis-zhanghanbo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gap-analysis
Source: https://github.com/ZhangHanbo/alpha_research/tree/main/skills/gap-analysis
Command: npx skills add https://github.com/ZhangHanbo/alpha_research --skill gap-analysis-zhanghanbo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Researchers need to uncover systemic weaknesses across many evaluated papers to define open problems, but manually reviewing each paper is time‑consuming and error‑prone.

Core Features & Use Cases

  • Aggregate evaluations from project memory JSONL records, summarising weakness counts and paper details.
  • Semantic clustering of identified weaknesses into meaningful gap categories, highlighting recurring limitations.
  • Automated verification of candidate gaps via literature search and cross‑reference with the researcher’s Hamming list.
  • Research direction synthesis that proposes concrete problems, cites motivating papers, and flags items for human judgment.
  • Persisted reporting of gap analysis results back into the project’s JSONL store.

Use case: After running a literature‑survey that produces 50 evaluation records, invoke this skill to automatically generate a structured gap report that powers the next significance‑screening step.

Quick Start

Ask the gap-analysis skill to synthesize research gaps from the latest literature survey.

Frequently Asked Questions about gap-analysis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify research gaps from a literature survey automatically?

To identify research gaps from a literature survey, you can aggregate evaluation records, apply semantic clustering to group recurring weaknesses, and verify candidate gaps using search APIs. This process synthesizes concrete research directions and flags items for human judgment.

What is the best way to cluster recurring limitations across multiple evaluated papers?

The best way to cluster recurring limitations across evaluated papers is using semantic clustering on aggregated weakness data. This method groups identified weaknesses into meaningful gap categories and highlights systemic problems found within your literature survey outputs.

Do I need Python to generate a gap analysis report from JSONL records?

Yes, you need Python execution to generate a gap analysis report from JSONL records. The system requires Python for data aggregation, relies on project memory JSONL records for input, and uses search APIs for automated verification of candidate gaps.

How does semantic clustering verify real research gaps against a Hamming list?

Semantic clustering verifies real research gaps by cross-referencing clustered weaknesses against your Hamming list and validating them via search APIs. This automated verification ensures proposed research directions are backed by motivating papers and existing literature.

Can I use Bash and Grep to aggregate weakness counts for a robotics literature review?

Yes, you can use Bash, Grep, Read, and Write to aggregate weakness counts for a robotics literature review. The process avoids external tools beyond these, relying on Python execution to parse JSONL records and summarize paper details efficiently.

When should I not use automated gap synthesis for my literature survey outputs?

You should not use automated gap synthesis if your project lacks JSONL records or Python execution capabilities. The system depends on structured evaluation data from a prior literature survey and requires search APIs to verify candidate gaps and generate persisted reports.