table-filler

WILLOSCAR's avatarfrom WILLOSCAR

Fill `outline/tables.md` from `outline/table_schema.md` + evidence packs (NO PROSE in cells; citation-backed rows).**Trigger**: table filler, fill tables, evidence-first tables, 表格填充, 从证据包填表.**Use when**: table schema exists and evidence packs are ready; you want tables that never copy outline placeholders.**Skip if**: `outline/tables.md` already exists and is refined (>=2 tables; citations in rows; no placeholders).**Network**: none.**Guardrail**: do not invent facts; every row must include citations; do not write paragraph cells.

⭐1stars🔀0forks📁View on GitHub🕐Updated Jan 10, 2026
[Technical Writing]

When & Why to Use This Skill

The Table Filler skill is a specialized tool designed to automate the creation of structured, citation-backed Markdown tables. By synthesizing information from evidence packs according to a predefined schema, it ensures that all generated content is factually grounded and professionally formatted. It features strict guardrails to prevent AI hallucinations, such as prohibiting invented facts and placeholders, making it an essential utility for high-integrity technical documentation and research synthesis.

Use Cases

  • Academic and Scientific Research: Automatically generating complex data tables where every entry must be mapped to a specific citation in a bibliography file to ensure peer-review readiness.
  • Technical Product Documentation: Filling out feature comparison or specification tables in technical manuals using verified evidence drafts, ensuring no 'TODO' placeholders or prose-heavy cells remain.
  • Evidence-Based Reporting: Creating concise, fact-heavy summaries for market analysis or internal audits where data integrity is paramount and narrative fluff must be avoided.
nametable-filler
description|
**Trigger**table filler, fill tables, evidence-first tables, 表格填充, 从证据包填表.
**Use when**table schema exists and evidence packs are ready; you want tables that never copy outline placeholders.
**Skip if**`outline/tables.md` already exists and is refined (>=2 tables; citations in rows; no placeholders).
**Network**none.
**Guardrail**do not invent facts; every row must include citations; do not write paragraph cells.

Table Filler (Evidence-first)

Purpose: generate readable, citation-backed tables from evidence packs, with strict anti-placeholder rules.

Inputs

  • outline/table_schema.md
  • outline/subsection_briefs.jsonl
  • outline/evidence_drafts.jsonl
  • citations/ref.bib

Outputs

  • outline/tables.md

Non-negotiables

  • No placeholders: no TODO, <!-- SCAFFOLD -->, ellipsis (…), or instruction text.
  • No invented facts: tables only restate what is present in evidence packs.
  • Every row must contain citations ([@BibKey]).

Helper script

  • python .codex/skills/table-filler/scripts/run.py --help
  • python .codex/skills/table-filler/scripts/run.py --workspace <ws>

Script

Quick Start

  • python .codex/skills/table-filler/scripts/run.py --help
  • python .codex/skills/table-filler/scripts/run.py --workspace <ws>

All Options

  • See --help.
  • Requires: outline/table_schema.md, outline/subsection_briefs.jsonl, outline/evidence_drafts.jsonl, citations/ref.bib.

Examples

  • Fill tables from schema + evidence packs:
    • Ensure outline/table_schema.md defines >=2 tables.
    • Ensure outline/evidence_drafts.jsonl has empty blocking_missing.
    • Ensure citations/ref.bib contains all cited keys.
    • Run: python .codex/skills/table-filler/scripts/run.py --workspace workspaces/<ws>

Troubleshooting

Issue: table cells become long prose

Fix:

  • Convert cells into atomic facts/comparisons and keep prose out of table cells; move narrative into a draft section.

Issue: rows cannot be filled from evidence packs

Fix:

  • Treat this as an evidence gap: enrich outline/evidence_drafts.jsonl or adjust the schema in outline/table_schema.md.