From d3fd874330d363e490bce64ff2f423ac35d4d49f Mon Sep 17 00:00:00 2001
From: Stefano Fiorini <stefano@Stefanos-MacBook-Air.local>
Date: Sun, 15 Mar 2026 01:34:14 -0500
Subject: [PATCH] docs: finalize us-cpa integration and fixtures

---
 README.md                                                 | 1 +
 docs/README.md                                            | 1 +
 skills/us-cpa/tests/fixtures/facts/overlay-case-2025.json | 6 ++++++
 .../us-cpa/tests/fixtures/facts/review-mismatch-2025.json | 8 ++++++++
 skills/us-cpa/tests/fixtures/facts/schedule-c-2025.json   | 6 ++++++
 .../tests/fixtures/facts/simple-w2-interest-2025.json     | 7 +++++++
 6 files changed, 29 insertions(+)
 create mode 100644 skills/us-cpa/tests/fixtures/facts/overlay-case-2025.json
 create mode 100644 skills/us-cpa/tests/fixtures/facts/review-mismatch-2025.json
 create mode 100644 skills/us-cpa/tests/fixtures/facts/schedule-c-2025.json
 create mode 100644 skills/us-cpa/tests/fixtures/facts/simple-w2-interest-2025.json

diff --git a/README.md b/README.md
index e4710fa..b050c14 100644
--- a/README.md
+++ b/README.md
@@ -21,6 +21,7 @@ This repository contains practical OpenClaw skills and companion integrations. I
 | `nordvpn-client` | Install, log in to, connect, disconnect, and verify NordVPN sessions across Linux CLI and macOS NordLynx/WireGuard backends. | `skills/nordvpn-client` |
 | `portainer` | Manage Portainer stacks via API (list, start/stop/restart, update, prune images). | `skills/portainer` |
 | `searxng` | Search through a local or self-hosted SearXNG instance for web, news, images, and more. | `skills/searxng` |
+| `us-cpa` | Federal individual 1040 workflow for tax questions, case intake, preparation, review, and draft e-file-ready export. | `skills/us-cpa` |
 | `web-automation` | One-shot extraction plus broader browsing/scraping with Playwright-compatible CloakBrowser (auth flows, extraction, bot-protected sites). | `skills/web-automation` |
 
 ## Integrations
diff --git a/docs/README.md b/docs/README.md
index 339baf3..68757c5 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -9,6 +9,7 @@ This folder contains detailed docs for each skill in this repository.
 - [`nordvpn-client`](nordvpn-client.md) — Cross-platform NordVPN install, login, connect, disconnect, and verification with Linux CLI and macOS NordLynx/WireGuard support
 - [`portainer`](portainer.md) — Portainer stack management (list, lifecycle, updates, image pruning)
 - [`searxng`](searxng.md) — Privacy-respecting metasearch via a local or self-hosted SearXNG instance
+- [`us-cpa`](us-cpa.md) — Federal individual 1040 workflow for tax questions, case intake, preparation, review, and draft e-file-ready export
 - [`web-automation`](web-automation.md) — One-shot extraction plus Playwright-compatible CloakBrowser browser automation and scraping
 
 ## Integrations
diff --git a/skills/us-cpa/tests/fixtures/facts/overlay-case-2025.json b/skills/us-cpa/tests/fixtures/facts/overlay-case-2025.json
new file mode 100644
index 0000000..40fb20c
--- /dev/null
+++ b/skills/us-cpa/tests/fixtures/facts/overlay-case-2025.json
@@ -0,0 +1,6 @@
+{
+  "taxpayer.fullName": "Olivia Overlay",
+  "filingStatus": "single",
+  "wages": 42000,
+  "federalWithholding": 5000
+}
diff --git a/skills/us-cpa/tests/fixtures/facts/review-mismatch-2025.json b/skills/us-cpa/tests/fixtures/facts/review-mismatch-2025.json
new file mode 100644
index 0000000..05b0809
--- /dev/null
+++ b/skills/us-cpa/tests/fixtures/facts/review-mismatch-2025.json
@@ -0,0 +1,8 @@
+{
+  "taxpayer.fullName": "Jane Doe",
+  "filingStatus": "single",
+  "wages": 50000,
+  "taxableInterest": 100,
+  "federalWithholding": 6000,
+  "expectedIssue": "agi_mismatch"
+}
diff --git a/skills/us-cpa/tests/fixtures/facts/schedule-c-2025.json b/skills/us-cpa/tests/fixtures/facts/schedule-c-2025.json
new file mode 100644
index 0000000..7c50db4
--- /dev/null
+++ b/skills/us-cpa/tests/fixtures/facts/schedule-c-2025.json
@@ -0,0 +1,6 @@
+{
+  "taxpayer.fullName": "Jamie Owner",
+  "filingStatus": "single",
+  "businessIncome": 12000,
+  "federalWithholding": 0
+}
diff --git a/skills/us-cpa/tests/fixtures/facts/simple-w2-interest-2025.json b/skills/us-cpa/tests/fixtures/facts/simple-w2-interest-2025.json
new file mode 100644
index 0000000..2a2c367
--- /dev/null
+++ b/skills/us-cpa/tests/fixtures/facts/simple-w2-interest-2025.json
@@ -0,0 +1,7 @@
+{
+  "taxpayer.fullName": "Jane Doe",
+  "filingStatus": "single",
+  "wages": 50000,
+  "taxableInterest": 100,
+  "federalWithholding": 6000
+}