Agent Skills: Skill: inbox-report-writer

required_canon_version: >=3.0.0

Skill: inbox-report-writer

Version: 0.2.0

Status: Active

Trigger

Use when generating INBOX ledgers, updating INBOX.md indexes, validating INBOX content hashes, or writing canonical reports to INBOX.

Inputs

• input.json with:
  • operation: generate_ledger | update_index | verify_hash | write_report
  • inbox_path: repo-relative path (default: INBOX)
  • ledger_path: output path under LAW/CONTRACTS/_runs (required for generate_ledger)
  • file_path: repo-relative path (required for verify_hash)
  • allow_inbox_write: true to permit update_index
  • For write_report:
    • title: (required) Report title
    • body: (required) Markdown body content
    • uuid: Agent session UUID (default: 00000000-0000-0000-0000-000000000000)
    • section: report | research | roadmap | guide (default: report)
    • bucket: Category path (default: reports)
    • author: Author name (default: System)
    • priority: High | Medium | Low (default: Medium)
    • status: Complete | Draft | In Progress (default: Complete)
    • summary: One-line summary (auto-generated if empty)
    • tags: List of tags (default: [])
    • output_subdir: INBOX subdirectory (default: reports)

Outputs

• output.json summary with status, operation, and any output paths.
• Optional ledger file written under LAW/CONTRACTS/_runs/.
• For write_report: report_path, filename, report_written fields.

Constraints

• Output JSON is deterministic.
• Ledger outputs must stay under LAW/CONTRACTS/_runs/.
• INBOX writes require explicit allow_inbox_write (for update_index).
• Reports written via write_report follow DOCUMENT_POLICY.md format.

Fixtures

• fixtures/basic/

required_canon_version: >=3.0.0