paper-experiment-stub

Generates a deterministic 20-row results CSV seeded from a topic hash.

6.8k|540|Updated May 6, 2026
One-click install
npx skills add https://github.com/opensquilla/opensquilla --skill paper-experiment-stub
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paper-experiment-stub
Source: https://github.com/opensquilla/opensquilla/tree/main/src/opensquilla/skills/bundled/paper-experiment-stub
Command: npx skills add https://github.com/opensquilla/opensquilla --skill paper-experiment-stub

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Demo and testing workflows for the meta-paper-write pipeline need a repeatable experiment output without running real experiments, and this Skill produces a stable placeholder dataset on demand.

Core Features & Use Cases

  • Deterministic CSV Generation: Creates a 20-row results.csv with columns x, y_baseline, and y_ours seeded from the SHA-256 hash of the topic phrase.
  • Reproducible Re-runs: The same topic always yields identical rows, making it suitable for testing downstream paper-writing or plotting steps.
  • Use Case: While developing an automated paper-writing workflow, invoke this stub with a topic like "graph routing" to instantly get a synthetic baseline-versus-ours results table for formatting and rendering tests.

Quick Start

Ask the agent to run the stub experiment for your topic, for example: generate stub experiment results for the topic "agent routing".

Frequently Asked Questions about paper-experiment-stub

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

FAQPage Schema
How do I generate deterministic test data in Python?

Seed Python's random.Random with a stable value derived from your input, such as the first 8 bytes of its SHA-256 hash. This stub uses that approach so the same topic string always produces the same 20-row CSV.

What does the generated results.csv contain?

The CSV has a header row x, y_baseline, y_ours followed by 20 data rows. Baseline values grow slightly with x, and y_ours adds a random improvement of 0.05 to 0.15 capped at 0.99.

Does this stub require any external Python packages?

No, it uses only the Python standard library: argparse, csv, hashlib, random, and pathlib. Any Python 3 interpreter can run it without installing dependencies.

Can I use this stub for real research results?

No, the output is explicitly demo-only synthetic data and not real science. It exists to test the meta-paper-write pipeline's formatting and rendering steps, not to produce valid experimental findings.

Why do repeated runs with the same topic give identical output?

The random generator is seeded from the SHA-256 digest of the topic string rather than system entropy. Identical input therefore always produces the identical sequence of random values.