Agent skill
table-filler
Fill `outline/tables_index.md` from `outline/table_schema.md` + evidence packs (NO PROSE in cells; citation-backed rows). **Trigger**: table filler, fill tables, evidence-first tables, index tables, 表格填充, 索引表. **Use when**: table schema exists and evidence packs are ready; you want a compact, citation-backed index table to support later writing and Appendix table curation. **Skip if**: `outline/tables_index.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.
Install this agent skill to your Project
npx add-skill https://github.com/WILLOSCAR/research-units-pipeline-skills/tree/main/.codex/skills/table-filler
SKILL.md
Table Filler (index tables, evidence-first)
Goal: produce outline/tables_index.md as an internal, citation-backed index.
This file is a planning/traceability artifact:
- it is useful for debugging coverage and for quickly seeing what evidence exists
- it should NOT be pasted into the paper verbatim
Reader-facing tables belong in outline/tables_appendix.md and are curated by appendix-table-writer.
Default mode: semantic (LLM-first)
Treat this as filling a table artifact from evidence packs:
- restate evidence pack content in compact cells
- attach citations in the row (avoid cite-dump paragraphs)
Workflow (explicit inputs)
- Read
outline/table_schema.mdfirst (it defines what each table must answer). - Use
outline/subsection_briefs.jsonl+outline/evidence_drafts.jsonlto fill the subsection map and pick in-scope citations. - Use
outline/anchor_sheet.jsonlto fill the anchor-fact table (prefer quant/eval hooks). - Validate cite keys against
citations/ref.bib.
Inputs
outline/table_schema.mdoutline/subsection_briefs.jsonloutline/evidence_drafts.jsonloutline/anchor_sheet.jsonlcitations/ref.bib
Output
outline/tables_index.md
Output format contract
outline/tables_index.md must:
- contain >=2 Markdown tables
- use a caption line before each table, e.g.
**Index Table 1. ...** - contain no Markdown headings (
#,##,###) unless you explicitly want them for internal readability - include citations in rows using
[@BibKey] - avoid placeholders (
TODO,...,…, scaffold comments) - avoid paragraph cells (short phrases; use
<br>sparingly)
What to fill (recommended defaults)
- Subsection map (axes + representative works)
- Axes come from
subsection_briefs.axes. - Representative works come from citations in the evidence pack.
- Concrete anchors (benchmarks / numbers / caveats)
- Anchor facts come from
outline/anchor_sheet.jsonl(curated, citation-backed). - Representative works come from citations in the anchor sheet (or the evidence pack as fallback).
Common failure modes
-
Cells become long prose
- Fix: compress into short phrases; move narrative explanation into prose sections.
-
Rows cannot be filled without guessing
- Fix: treat as an evidence gap (route to
evidence-selfloop/evidence-draft) OR narrow the schema.
- Fix: treat as an evidence gap (route to
Script (optional bootstrap)
Quick Start
python .codex/skills/table-filler/scripts/run.py --helppython .codex/skills/table-filler/scripts/run.py --workspace workspaces/<ws>
All Options
--workspace <workspace_dir>(required)--unit-id <id>(optional; used only for runner bookkeeping)--inputs <schema;briefs;packs;anchors;bib>(optional; override inputs)--outputs <relpath>(optional; defaults tooutline/tables_index.md)--checkpoint <C#>(optional; ignored by the bootstrapper)
Examples
-
Bootstrap index tables (default output path):
python .codex/skills/table-filler/scripts/run.py --workspace workspaces/<ws> -
Write to a custom index file (rare):
python .codex/skills/table-filler/scripts/run.py --workspace workspaces/<ws> --outputs outline/tables_index.md
Notes:
- The script is deterministic bootstrap; treat the result as an internal index artifact.
- Curate reader-facing Appendix tables separately via
appendix-table-writer.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
thesis-compile-review
对中文毕业论文进行编译、warning 分级、模板模式检查、数据与引用复查,并把问题回写成可继续迭代的 review checklist。 **Trigger**: 毕业论文编译检查, thesis compile review, warning 分级, 终稿复查, main.pdf 检查. **Use when**: 论文已经回写到 TeX 交付层,需要确认是否真正达到“可提交”的质量,而不是只做到能编译。 **Skip if**: 还处于中间层重构阶段,`chapters/*.tex` 尚未形成稳定交付稿。 **Network**: none. **Guardrail**: 不在这里重构章节主线;如果发现结构问题,明确回退到上游修复。
front-matter-writer
Write the survey's front matter files (Abstract, Introduction, Related Work, Discussion, Conclusion) in paper voice, with high citation density and a single evidence-policy paragraph. **Trigger**: front matter writer, introduction writer, related work writer, abstract writer, discussion writer, conclusion writer, 引言, 相关工作, 摘要, 讨论, 结论. **Use when**: you are in C5 (prose allowed) and need the paper-like shell to stop the draft reading like stitched subsections. **Skip if**: `Approve C2` is missing in `DECISIONS.md`, or `citations/ref.bib` is missing. **Network**: none. **Guardrail**: no invented facts/citations; no pipeline jargon in final prose; no repeated evidence disclaimers; only use keys present in `citations/ref.bib`.
thesis-question-list
维护中文毕业论文的 `codex_md/question_list.md`:把本轮问题、边界、优先级、协作方案和验收口径结构化,作为整条 thesis pipeline 的控制面。 **Trigger**: 毕业论文问题清单, thesis question list, 论文修改清单, 本轮目标, 结构问题梳理, review问题整理. **Use when**: 你已经有一批材料或上一轮 review 结果,需要明确这一轮到底修什么、不修什么,并给后续重构与编译复查提供统一入口。 **Skip if**: 当前只是在做一次性局部措辞修改,且没有形成新一轮结构/证据/编译问题。 **Network**: none. **Guardrail**: 不在这里写正文;不把问题单写成长篇散文;每条问题必须可执行、可验收。
novelty-matrix
Create a novelty/prior-work matrix comparing the submission’s contributions against related work (overlaps vs deltas). **Trigger**: novelty matrix, prior-work matrix, overlap/delta, 相关工作对比, 新颖性矩阵. **Use when**: peer review 中评估 novelty/positioning,需要把贡献与相关工作逐项对齐并写出差异点证据。 **Skip if**: 缺少 claims(先跑 `claims-extractor`)或你不打算做新颖性定位分析。 **Network**: none (retrieval of additional related work is out-of-scope unless provided). **Guardrail**: 明确 overlap 与 delta;尽量给出可追溯证据来源(来自稿件/引用/作者陈述)。
protocol-writer
Write a systematic review protocol into `output/PROTOCOL.md` (databases, queries, inclusion/exclusion, time window, extraction fields). **Trigger**: protocol, PRISMA, systematic review, inclusion/exclusion, 检索式, 纳入排除. **Use when**: systematic review pipeline 的起点(C1),需要先锁定 protocol 再开始 screening/extraction。 **Skip if**: 不是做 systematic review(或 protocol 已经锁定且不允许修改)。 **Network**: none. **Guardrail**: protocol 必须包含可执行的检索与筛选规则;需要 HUMAN 签字后才能进入 screening。
rubric-writer
Write a rubric-based peer review report (`output/REVIEW.md`) using extracted claims and evidence gaps (novelty/soundness/clarity/impact). **Trigger**: rubric review, referee report, peer review write-up, 审稿报告, REVIEW.md. **Use when**: peer-review pipeline 的最后阶段(C3),已有 `output/CLAIMS.md` + `output/MISSING_EVIDENCE.md`(以及可选 novelty matrix)。 **Skip if**: 上游产物未就绪(claims/evidence gaps 缺失)或你不打算输出完整审稿报告。 **Network**: none. **Guardrail**: 给可执行建议(actionable feedback),并覆盖 novelty/soundness/clarity/impact;避免泛泛而谈。
Didn't find tool you were looking for?