claim-ledger-to-tasks

Convert unverified numeric claims from a claim ledger into JSON verification tasks.

Updated Dec 17, 2025
One-click install
npx skills add https://github.com/haizhouyuan/codexreadpublic --skill claim-ledger-to-tasks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claim-ledger-to-tasks
Source: https://github.com/haizhouyuan/codexreadpublic/tree/main/skills-src/claim-ledger-to-tasks
Command: npx skills add https://github.com/haizhouyuan/codexreadpublic --skill claim-ledger-to-tasks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill scans a topic's Claim Ledger from digests and converts unverified, high-impact numeric claims into concrete verification tasks. It helps teams move from noisy numbers to trackable, actionable work.

Core Features & Use Cases

  • Deterministic task creation: Batch-create tasks with topic_id and relevant labels (e.g., bvid) for easy Kanban filtering.
  • Dry-run previews: Preview results before creating tasks to avoid misclassification.
  • Traceable outputs: Outputs tasks in a JSON-friendly format to enable backtracking and auditing.

Quick Start

  1. Dry-run: python3 scripts/claim_ledger_to_tasks.py --topic <topic_id> --dry-run --max-total 20 --max-per-digest 2
  2. Official creation: python3 scripts/claim_ledger_to_tasks.py --topic <topic_id> --max-total 80 --max-per-digest 2

Frequently Asked Questions about claim-ledger-to-tasks

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

FAQPage Schema
How do I convert unverified claims from a ledger into verification tasks?

Convert unverified numeric claims into trackable tasks by running the claim-ledger-to-tasks script with your topic ID. The Skill filters high-impact items with compact numeric facts, assigns pending status, and outputs tasks as JSON with topic_id and bvid labels for Kanban filtering and audit trails.

Can I preview tasks before creating them in bulk?

Yes, use the dry-run flag to preview results without committing changes. Run `python3 scripts/claim_ledger_to_tasks.py --topic <topic_id> --dry-run` to see which claims will become tasks, then execute the official creation command once you verify the output.

What numeric claims does this Skill extract for verification?

The Skill targets compact numeric facts—numbers paired with units or percentages—from unverified claim ledger entries. It filters for high-impact items only, applying configurable limits per digest and total batch size to keep verification workload manageable.

How do I control the volume of tasks created?

Set `--max-total` to cap the total task batch and `--max-per-digest` to limit tasks per individual digest. These parameters prevent task overload while ensuring high-priority claims get verified first.

Where are the created tasks stored and how do I audit them?

Tasks output to JSON files in `state/tmp/claim_tasks_created_*.json` for full traceability. Each task includes topic_id and bvid metadata, enabling backtracking, filtering in Kanban boards, and complete audit records of what claims became verification work.

Do I need a claim ledger digest to use this Skill?

Yes, your topic must first produce digests that include a Claim Ledger. The Skill scans these ledgers to identify unverified numeric claims; without digests, there is no source material to convert into tasks.