Agent skill

Emerge Forward Synthesis

by jianzhichun in jianzhichun/emerge

Distill Emerge forward flywheel WAL samples into a parameterized pipeline result.

MITAuto-check passedDocuments & Office

Install Emerge Forward Synthesis

skills CLI
$ npx skills add jianzhichun/emerge --skill emerge-forward-synthesis -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jianzhichun/emerge emerge-forward-synthesis --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jianzhichun/emerge.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/emerge-forward-synthesis .claude/skills/emerge-forward-synthesis && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
emerge-forward-synthesis
GitHub stars
104
Token cost
~585 tokens
SKILL.md length
220 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

Distill Emerge forward flywheel WAL samples into a parameterized pipeline result.

  • Works in 7 steps: Compare all samples. Literals that vary… → Be conservative. If unsure whether a… → Remove dead code: no print, debug… → …
  • A lead agent receives a forwardsynthesispending event
  • SKILL.md covers Purpose, Inputs, Rules and Output JSON, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Emerge Forward Synthesis is an agent skill from jianzhichun/emerge. Distill Emerge forward flywheel WAL samples into a parameterized pipeline result. Use when a lead agent receives a forwardsynthesispending event or a job with skillname=emerge-forward-synthesis.

Its SKILL.md is about 590 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office. It works with Microsoft Excel. The licence is MIT.

When your agent uses it

  • A lead agent receives a forwardsynthesispending event
  • A job with skillname=emerge-forward-synthesis

Example prompts

  • “/emerge-forward-synthesis”

Requirements

  • Python 3

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Compare all samples. Literals that vary with sample args should become __args["name"].
  2. Be conservative. If unsure whether a literal is a parameter, keep it constant.
  3. Remove dead code: no print, debug logging, timing noise, or exploratory branches.
  4. Do not introduce new dependencies unless connector notes already require them.
  5. For read mode, assign result. For write mode, assign action.
  6. Generate a stronger verify strategy. Prefer required_fields, type checks, and row-shape checks over bool(rows).
  7. Validate the candidate through icc_exec with no_replay=true, then write the pending artifact yourself using the normal file-editing tools.

What it can do on your machine

Read from SKILL.md and the folder at commit 035db30. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Emerge Forward Synthesis loads about 585 tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 220 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~585

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jianzhichun/emerge at commit 035db30, republished under its MIT licence (© jianzhichun). 220 words, ~585 tokens.

Download SKILL.mdSave it as .claude/skills/emerge-forward-synthesis/SKILL.md (or your agent's skills folder).
name
emerge-forward-synthesis
description
Distill Emerge forward flywheel WAL samples into a parameterized pipeline result. Use when a lead agent receives a forward_synthesis_pending event or a job with skill_name=emerge-forward-synthesis.

Emerge Forward Synthesis

Purpose

Turn successful icc_exec WAL samples into one deterministic pipeline candidate. The Python daemon is only a coordinator; you are the lead agent doing distillation.

Inputs

Use the job payload from forward_synthesis_pending:

  • normalized_intent: target connector.mode.pipeline_name
  • samples: successful exec samples with code, args, optional result
  • connector NOTES.md and synthesis_hints.yaml when included

Rules

  1. Compare all samples. Literals that vary with sample args should become __args["name"].
  2. Be conservative. If unsure whether a literal is a parameter, keep it constant.
  3. Remove dead code: no print, debug logging, timing noise, or exploratory branches.
  4. Do not introduce new dependencies unless connector notes already require them.
  5. For read mode, assign __result. For write mode, assign __action.
  6. Generate a stronger verify strategy. Prefer required_fields, type checks, and row-shape checks over bool(rows).
  7. Validate the candidate through icc_exec with no_replay=true, then write the pending artifact yourself using the normal file-editing tools.

Output JSON

Use this shape in your working notes and pending artifact rationale:

json
{
  "connector": "mock",
  "mode": "read",
  "pipeline_name": "sheet",
  "code": "__result = [{'file': __args['filename']}]",
  "confidence": 0.91,
  "rationale": "filename varied across samples, so it was parameterized; sheet name was constant.",
  "verify_strategy": {
    "required_fields": ["file"]
  }
}

Few-Shot Patterns

Varying file path

Samples use /tmp/a.xlsx, /tmp/b.xlsx, /tmp/c.xlsx and each sample args has filename.

Output code should use __args["filename"].

Constant file path

All samples use /tmp/q3.xlsx and there is no input arg explaining it.

Keep /tmp/q3.xlsx literal. 保守优先: do not invent __args["filename"].

Required fields

If every successful __result row has name and area, include:

json
{"verify_strategy": {"required_fields": ["name", "area"]}}

© jianzhichun, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/emerge-forward-synthesis of jianzhichun/emerge.

Open the folder on GitHubat commit 035db30

Compare with similar skills

Emerge Forward Synthesis next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Emerge Forward Synthesis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Emerge Forward Synthesis this skilljianzhichun/emerge104—~585Automated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
GenOffice Document CLIgenspark-ai/genoffice9.2k—~19kAutomated safety check: PassApache-2.0
Data Table Managern8n-io/n8n207k—~2.3kAutomated safety check: PassCustom licence
Docx4jplutext/docx4j2.4k—~2.5kAutomated safety check: PassNone
Instrument Data To Allotropeaws-samples/amazon-bedrock-agents-healthcare-lifesciences2742 repos~2.7kAutomated safety check: PassApache-2.0

Similar skills

  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • GenOffice Document CLI

    genspark-ai/genoffice

    Creates, converts, reads and edits real pptx, xlsx, docx and PDF files locally through the genoffice command line.

    9.2k GitHub stars~19k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Official

    Load before calling data-tables or parse-file. An agent skill from n8n-io/n8n.

    207k GitHub stars~2.3k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Docx4j

    plutext/docx4j

    A skill your agent uses when writing Java code that creates, reads or edits Word (.docx), PowerPoint (.pptx) or Excel (.xlsx) files with docx4j — including generating documents, editing existing…

    2.4k GitHub stars~2.5k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Instrument Data To Allotrope

    aws-samples/amazon-bedrock-agents-healthcare-lifesciences

    Official

    Convert laboratory instrument output files (PDF, CSV, Excel, TXT) to Allotrope Simple Model (ASM) JSON format or flattened 2D CSV.

    274 GitHub starsUsed in 2 repos~2.7k tokens
    Documents & OfficeAuto-check passed
  • Cyber Ppt

    crazyykhllc-bit/CyberPPT

    当用户需要把 DOCX、PDF、TXT、XLSX、研究报告、业务材料或原始数据转成高密度、可编辑、咨询风格 PPTX 时使用;也适用于需要 SCR 论证、视觉风格探索、详细图表和渲染质检的 PPT。

    1.8k GitHub stars~10k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed

More from jianzhichun/emerge

All 14 skills in this repo
  • Distilling Operator Flows

    jianzhichun/emerge

    A skill your agent uses when wiring a generic connector to capture remote operator actions and convert repeated event facts into pending pipeline work through Claude Code skills.

    104 GitHub stars~432 tokensUpdated 5 mo ago
    Auto-check passed
  • Emerge Reverse Synthesis

    jianzhichun/emerge

    Distill Emerge reverse flywheel raw operator events into a structured synthesis result.

    104 GitHub stars~451 tokensUpdated 5 mo ago
    Auto-check passed
  • A skill your agent uses when a user asks to initialize a domain flywheel from natural language context, especially when environment details are incomplete or mixed with execution assumptions.

    104 GitHub stars~2.2k tokensUpdated 5 mo ago
    Auto-check passed
  • Operator Monitor Debug

    jianzhichun/emerge

    A skill your agent uses when the operator monitoring pipeline appears broken: EventBus has no events, PatternDetector is not firing, elicitation dialog never appears, or OperatorMonitor is silent.

    104 GitHub stars~1k tokensUpdated 5 mo ago
    Auto-check passed
  • Policy Optimization

    jianzhichun/emerge

    A skill your agent uses when policy health needs tuning: too many explore pipelines, repeated failures, stalled promotions, or noisy rollback behavior.

    104 GitHub stars~916 tokensUpdated 5 mo ago
    Auto-check passed
  • Reflection Deep Dive

    jianzhichun/emerge

    A skill your agent uses when connector flywheel history is large/noisy and lightweight reflection is insufficient.

    104 GitHub stars~325 tokensUpdated 5 mo ago
    Auto-check passed

Works with

Questions about Emerge Forward Synthesis

What does Emerge Forward Synthesis do?

Distill Emerge forward flywheel WAL samples into a parameterized pipeline result. Emerge Forward Synthesis is an agent skill from jianzhichun/emerge. Distill Emerge forward flywheel WAL samples into a parameterized pipeline result.

When should I use Emerge Forward Synthesis?

Emerge Forward Synthesis fits situations like: A lead agent receives a forwardsynthesispending event; A job with skillname=emerge-forward-synthesis.

How do I install Emerge Forward Synthesis in Claude Code?

Run `npx skills add jianzhichun/emerge --skill emerge-forward-synthesis -a claude-code`. Or copy the skill folder (skills/emerge-forward-synthesis in jianzhichun/emerge) into .claude/skills/emerge-forward-synthesis in your project. Claude Code loads it when a task matches its description.

How do I install Emerge Forward Synthesis in Codex?

Run `npx skills add jianzhichun/emerge --skill emerge-forward-synthesis -a codex`. Or copy the skill folder (skills/emerge-forward-synthesis in jianzhichun/emerge) into .agents/skills/emerge-forward-synthesis in your project. Codex loads it when a task matches its description.

Can I use Emerge Forward Synthesis in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jianzhichun/emerge --skill emerge-forward-synthesis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/emerge-forward-synthesis, .gemini/skills/emerge-forward-synthesis, .github/skills/emerge-forward-synthesis and .opencode/skills/emerge-forward-synthesis in your project.

What does Emerge Forward Synthesis need to run?

SKILL.md names no scripts, command-line tools or credentials: Emerge Forward Synthesis is instructions for the agent only. Our summary lists: Python 3.

Does Emerge Forward Synthesis access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Emerge Forward Synthesis safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Emerge Forward Synthesis use?

Emerge Forward Synthesis is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Emerge Forward Synthesis use?

About 585 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Emerge Forward Synthesis?

Skills that share tags, products or a category with Emerge Forward Synthesis: Markitdown (ImCa0/just-laws, 781 stars), GenOffice Document CLI (genspark-ai/genoffice, 9.2k stars), Data Table Manager (n8n-io/n8n, 207k stars) and Docx4j (plutext/docx4j, 2.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Emerge Forward Synthesis?

jianzhichun (a GitHub user) maintains it in jianzhichun/emerge, which has 104 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on April 26, 2026.

Source: jianzhichun/emerge on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.