survey-generator

---
name: survey-generator
description: Generate a polished, single-file HTML survey paper on any AI/ML topic by curating a research bundle from a public anchor resource and handing it to Kimi K2.6 via the Fireworks API for one-shot artifact generation. Use when the user asks for a "survey paper" or "literature review" artifact on a technical topic. The invoking agent does all research curation; Kimi K2.6 does the writing and inline SVG rendering.
allowed-tools: Read, Write, Bash, WebFetch, AskUserQuestion
---

# Survey Generator Skill

Generate an academic-style survey paper as a single self-contained HTML file.

## What this skill does

Given a topic and a public anchor resource, this skill:
1. Reads the anchor resource and extracts the landscape of relevant work.
2. Builds a structured `research_bundle.json` (title, taxonomy, sections, bibliography of real papers).
3. Calls Kimi K2.6 via the Fireworks chat completions API with the research bundle and a fixed `style_spec.json`.
4. Writes a single-file HTML artifact with inline SVG figures, an academic layout, numbered sections, and a References list.

The agent using this skill is responsible only for research curation. All prose, figures, and HTML are generated by Kimi K2.6 in one API call.

## Inputs from the user

The user invokes this skill with at minimum:

- `topic`: a concise survey topic, for example "Agentic Engineering" or "Reasoning Models".
- `source_url`: a public anchor resource. Any curated list, canonical blog post, arXiv survey, GitHub awesome-list, or index page works. Suggested starting points: [DAIR.AI AI Papers of the Week](https://github.com/dair-ai/AI-Papers-of-the-Week) (a continuously updated open-source index of notable AI/ML papers, well suited for broad topics), a GitHub awesome-* repo, an arXiv survey PDF, or a well-maintained papers page.

Optional:

- `bibliography_size`: target bibliography size. Default 20 for a quick survey. Use 40 to 50 for a comprehensive survey, 80 to 100 for an exhaustive one. Section length and token budget scale with this.
- `section_count`: number of sections, default 6 to 10.

If the user has not provided these, use AskUserQuestion to collect them before proceeding.

## Requirements

- `FIREWORKS_API_KEY` exported in the environment. The build script reads it from `os.environ`.
- Python 3 with stdlib only (urllib). No external dependencies.

## Workflow for the agent