survey-generator

Generate source-backed AI/ML survey papers as self-contained HTML with curated bibliographies.

2|1|Updated Aug 19, 2026
One-click install
npx skills add https://github.com/lanceyuu/mimiwork --skill survey-generator-lanceyuu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: survey-generator
Source: https://github.com/lanceyuu/mimiwork/tree/main/coworker/skills/builtin/survey-generator
Command: npx skills add https://github.com/lanceyuu/mimiwork --skill survey-generator-lanceyuu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing an academic-style survey of a fast-moving AI/ML topic requires reading dozens of papers, building a taxonomy, curating a real bibliography, and producing polished figures and layout. This Skill automates that pipeline: the agent curates the research, and a single Fireworks API call to Kimi K2.6 renders the complete survey artifact. ## Core Features & Use Cases - Structured research bundle: Builds a research_bundle.json containing title, taxonomy, paradigms, stack layers, sections, a comparison table, and a bibliography of real papers with summaries. - One-call HTML generation: build_artifact.py sends the bundle plus a topic-agnostic style_spec.json to Kimi K2.6 via the Fireworks chat completions API and writes a versioned, self-contained HTML file with inline SVG figures and a numbered References section. - Deterministic figure contracts: The style spec pins exact SVG geometry for the taxonomy tree, paradigm panels, and stack diagram, with hard invariants that prevent overlapping nodes and clipped labels. - Use Case: Ask for a survey on "Reasoning Models" anchored to the DAIR.AI Papers of the Week repo; the agent curates 40-50 real papers, writes the bundle, runs the script, and produces output/survey_kimi-k2p6_v1.html ready to open or host. ## Quick Start Use the survey-generator skill to create a survey on Agentic Engineering anchored to the DAIR.AI AI Papers of the Week repository with a 40-paper bibliography.

Frequently Asked Questions about survey-generator

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

FAQPage Schema
How do I generate an AI survey paper as HTML?▼

Provide a topic and a public anchor source URL, then the agent curates a research_bundle.json with taxonomy, sections, and a real bibliography. Running python3 build_artifact.py calls Kimi K2.6 on Fireworks and writes a versioned self-contained HTML survey to the output directory.

What inputs does the survey generator need?▼

At minimum a topic and a source_url pointing to a curated list, arXiv survey, GitHub awesome-list, or index page. Optional inputs are bibliography_size (default 20, up to 100 tested) and section_count (default 6 to 10 sections).

Does the survey generator require an API key?▼

Yes, it requires FIREWORKS_API_KEY exported in the environment, which build_artifact.py reads from os.environ. You can also set FIREWORKS_MODEL to switch models, for example kimi-k2p5 for side-by-side comparison.

Can the generated survey HTML be edited directly?▼

No, the skill's hard rules forbid editing the generated HTML. To fix weak figures or thin prose, iterate on style_spec.json figure contracts or the section guidance fields in research_bundle.json and rerun the script.

What Python dependencies does build_artifact.py need?▼

None beyond the Python 3 standard library. The script uses only urllib, json, os, re, sys, time, and pathlib to call the Fireworks chat completions endpoint and write versioned output files.

Why do survey figures have overlapping or clipped labels?▼

Figure defects come from underspecified geometry in style_spec.json. The skill documents fixes: enforce rect pitch greater than rect height, pin panel translate offsets, use deterministic width formulas for sibling nodes, and add hard-invariant check clauses per figure.