create-notes

Write structured, actionable notes to a shared directory for future agents.

Updated Jul 15, 2026
One-click install
npx skills add https://github.com/Kurorz2004/alphaz-coral --skill create-notes-kurorz2004
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-notes
Source: https://github.com/Kurorz2004/alphaz-coral/tree/main/vrp/evidence/full/full-s1/.coral/public/skills/create-notes
Command: npx skills add https://github.com/Kurorz2004/alphaz-coral --skill create-notes-kurorz2004

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Agents working in multi-run experiments often leave behind notes that are walls of empty headings or final-design pitches with no record of rejected alternatives, forcing future agents to repeat failed work. This Skill standardizes how experiment, infra, focus, and synthesis notes are written so every note carries concrete numbers, mechanisms, and next steps that teammates can act on. ## Core Features & Use Cases - Four note variants: Experiment (per-eval reflection), Infra (grader/build/runtime issues), Focus (direction declaration with abandon-if gates), and Synthesis/Connections/Open-questions (consolidation outputs), each with its own frontmatter schema and section template. - Structured-trace frontmatter: Fields like type, claim, status, confidence, evidence, supersedes, and refutes populate a dashboard knowledge graph with typed edges and confidence-sized nodes. - Bundled helper scripts: stamp.py generates frontmatter-populated skeletons per variant, lint.py mechanizes the self-audit checklist (vocabulary, filename conventions, index cross-references), and unattributed.py finds notes missing the team-critical creator: field. - Use Case: After running a coral eval, an agent stamps an experiment skeleton, fills in results with baselines and deltas, lists rejected approaches, lints the note, and updates notes/index.md so the next agent can build on verified findings instead of rediscovering them. ## Quick Start Use the create-notes skill to write an experiment note for my latest eval by stamping a skeleton with scripts/stamp.py, filling in the result and mechanism sections, and validating it with scripts/lint.py.

Frequently Asked Questions about create-notes

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

FAQPage Schema
How do I write an experiment note after a coral eval?

Run scripts/stamp.py with the experiment variant to generate a frontmatter-populated skeleton, then fill in the Result table with absolute numbers and deltas versus a baseline, the Mechanism section, and at least two rejected approaches. Finish by running scripts/lint.py on the file and adding a one-line entry to notes/index.md.

What frontmatter fields does a note need for the knowledge graph?

Every note needs creator and created at minimum, plus variant-specific trace fields: experiment notes require claim, status, confidence, and evidence with attempt and verified; focus notes require claim, status untested, and confidence. The full field reference lives in references/frontmatter-spec.md.

Why does my note show up as unknown in coral notes?

A missing or blank creator field causes the note to render as (unknown) and be skipped by team-level attribution, consolidate rosters, and migration flows. Run scripts/unattributed.py to find affected files and append a creator line with your agent id to fix them.

Why did my markdown code blocks disappear when writing a note?

Writing markdown through python3 -c or echo lets bash interpret backticks as command substitution, silently stripping code blocks and inline code. Use the Write tool directly, scripts/stamp.py for skeletons, or a heredoc with single-quoted EOF to prevent shell expansion.

When should I write a synthesis note instead of an experiment note?

Write a synthesis note during a consolidate heartbeat when you can distill three or more related notes into a single team belief with cited attempt hashes, a confidence level, and named counter-evidence. Use an experiment note for per-eval reflections on a single attempt or small related set.