ts-idea2story

Convert a raw research idea into an 8-field structured story proposal with retrieved citation seeds.

1.1k|19|Updated Jun 18, 2026
One-click install
npx skills add https://github.com/Spark-To-Paper-Skills/spark-to-paper-skills --skill ts-idea2story-spark-to-paper-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ts-idea2story
Source: https://github.com/Spark-To-Paper-Skills/spark-to-paper-skills/tree/main/skills/ts-idea2story
Command: npx skills add https://github.com/Spark-To-Paper-Skills/spark-to-paper-skills --skill ts-idea2story-spark-to-paper-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires numpy, and includes scripts (resource) components.

What problem does it solve? Turning a vague research idea into a well-grounded, paper-ready proposal requires literature search, novelty assessment, and narrative structuring that is slow and error-prone when done manually. This Skill automates that upstream stage, producing a validated story.json, a Markdown proposal, and a verified citation seed for downstream paper writing. ## Core Features & Use Cases - Idea packaging and retrieval: Normalizes a raw idea into a structured brief, then recalls candidate research patterns from a knowledge graph via kg_recall.py (semantic + lexical + graph-boosted ranking). - Agentic literature search: Runs intent-tagged web searches (core method, contrast, evaluation) and records every real paper into retrieved_papers.json as a citation seed, never fabricating abstracts. - Critique-refine-fusion loop: Iteratively critiques the story against blind exemplars, routes defects to reserved patterns, and fuses conceptually with a calibrated pass bar capped at 3 rounds. - Integrity gates: novelty_check.py embeds the story and flags collision risk (0.82/0.88 bands), while story_lint.py enforces the 8-field schema and rejects fabricated results. - Use Case: A researcher with a one-line idea about reframing dense prediction as retrieval runs this Skill to get a validated story_proposal.md plus a deduplicated set of real supporting papers, ready to hand to the ts-paper pipeline. ## Quick Start Turn my research idea about using retrieval-augmented memory for long-horizon agents into a grounded research story proposal with supporting papers.

Frequently Asked Questions about ts-idea2story

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

FAQPage Schema
How do I turn a research idea into a structured paper proposal?

Provide the raw idea as text and the Skill packages it into a brief, recalls candidate patterns from a knowledge graph, searches the web for real papers, and generates an 8-field story.json plus a Markdown proposal. A lint gate validates the schema before handoff.

How does the novelty check for a research story work?

novelty_check.py embeds the story text via a TS_EMBED_* endpoint and cosine-compares it against retrieved paper abstracts or a pattern index. Similarity at or above 0.88 triggers a pivot to a differentiating pattern, 0.82 triggers a warning, with at most 2 pivots.

Can I use this without an embedding API endpoint configured?

Yes, the scripts degrade gracefully to lexical-only retrieval and judgment-based novelty checking, clearly labeling results as not a semantic guarantee. The novelty_report.json is still written so the check is never silently skipped.

What knowledge graph format does kg_recall.py expect?

It reads nodes_pattern.json, nodes_paper.json, and edges.json from a kg directory, optionally using pattern_emb.npy with a manifest for semantic ranking. A bundled kg_ai.rar archive is auto-extracted on first use, including Git LFS pointer resolution.

Does the generated story contain experimental results?

No, the output is a forward-looking proposal only. story_lint.py actively rejects fabricated numbers, bare percentages, and claims like outperforming SOTA by a margin, keeping experiments_plan and innovation_claims predictive.