opencode-skills-collection 4.1.0 → 4.1.2

package/bundled-skills/talking-avatar-video/SKILL.md

@@ -0,0 +1,260 @@
+---
+name: talking-avatar-video
+description: "Install and use the official Talking Avatar Video package, pinned by digest, for paid hosted work on the Beatra service."
+category: media
+risk: critical
+source: community
+source_repo: beatra-ai/talking-avatar-video-skill
+source_type: official
+date_added: "2026-09-18"
+author: beatra-ai
+tags: [talking-avatar, talking-head, text-to-video, mcp, paid-api, beatra]
+tools: [claude, codex, cursor, gemini]
+license: "MIT-0"
+license_source: "https://github.com/beatra-ai/talking-avatar-video-skill/blob/251c968deebb1c8f1dbfd0a8404e8e1be1528ac6/LICENSE"
+---
+
+# Talking Avatar Video Skill
+
+## Overview
+
+Turn one portrait and a short script into a talking avatar video, from inside Claude Code, Codex, or OpenClaw. The work is produced on the hosted, paid Beatra service
+(`mcp.beatra.ai`).
+
+This catalog entry is a **reviewed pointer, not the executable package**. It
+contains no client code and performs no Beatra operation by itself. The package
+it points to bundles three standard-library Python scripts that make network
+calls, store a credential, and can replace their own files. Read
+[Install](#install-pinned-verified-approved-twice) and
+[Security & Safety Notes](#security--safety-notes) before activating it.
+
+| Pinned identity | Value |
+| --- | --- |
+| Package | `talking-avatar-video` `0.2.1` |
+| Archive | `https://cdn.beatra.ai/agent-packages/talking-avatar-video/v0.2.1/talking-avatar-video-skill-0.2.1.zip` |
+| Archive SHA-256 | `cb62d8e3fa65b48f3c3f1803e2008e1b9c25ff057c0a35184e8fcc7d9771eb80` |
+| Source tree | [`beatra-ai/talking-avatar-video-skill@251c968`](https://github.com/beatra-ai/talking-avatar-video-skill/tree/251c968deebb1c8f1dbfd0a8404e8e1be1528ac6/skills/talking-avatar-video) (full SHA `251c968deebb1c8f1dbfd0a8404e8e1be1528ac6`) |
+| License | MIT No Attribution (MIT-0) |
+
+The archive holds regular files only (no symlinks, no executable bits, no
+binaries). Confirm that with the inspect commands below. Every file must be
+byte-identical to the source tree at the pinned commit.
+
+## When to Use This Skill
+
+- Use when the user explicitly wants Talking Avatar Video work produced on Beatra and accepts that it is paid.
+- Use when they have agreed to send prompts and any reference media to a third party.
+- Do not use for local-only or offline video editing, or timeline assembly.
+
+## Install (pinned, verified, approved twice)
+
+### Step 1: Download and verify into a review directory
+
+Explain that this downloads an external package from `cdn.beatra.ai`, then ask
+for approval. Only after approval:
+
+```bash
+umask 077
+review_dir="$(mktemp -d)"
+cd "$review_dir" || exit 1
+curl -fsSLO "https://cdn.beatra.ai/agent-packages/talking-avatar-video/v0.2.1/talking-avatar-video-skill-0.2.1.zip"
+printf '%s  %s\n' \
+  'cb62d8e3fa65b48f3c3f1803e2008e1b9c25ff057c0a35184e8fcc7d9771eb80' \
+  'talking-avatar-video-skill-0.2.1.zip' | shasum -a 256 -c -
+```
+
+Stop if the check does not print `OK`. The expected digest comes from this
+catalog entry, not from a file on the same CDN.
+
+### Step 2: Inspect before activation
+
+```bash
+unzip -l talking-avatar-video-skill-0.2.1.zip
+unzip -q talking-avatar-video-skill-0.2.1.zip
+find talking-avatar-video -type l -print            # expect no output
+find talking-avatar-video -type f -perm -111 -print # expect no output
+grep -n '"auto_update": True' talking-avatar-video/scripts/mcp_client.py
+```
+
+Optionally confirm byte identity with the public source tree (a second,
+independent host):
+
+```bash
+git clone --quiet --filter=blob:none --no-checkout https://github.com/beatra-ai/talking-avatar-video-skill.git src
+git -C src checkout --quiet 251c968deebb1c8f1dbfd0a8404e8e1be1528ac6 -- skills/talking-avatar-video
+(cd talking-avatar-video && find . -type f | LC_ALL=C sort | xargs shasum -a 256) > archive.sha
+(cd src/skills/talking-avatar-video && find . -type f | LC_ALL=C sort | xargs shasum -a 256) > tree.sha
+cmp archive.sha tree.sha && echo IDENTICAL
+```
+
+Report to the user what the review found: `SKILL.md`, `manifest.json`, the
+bundled Markdown references, and `scripts/authorize.py`,
+`scripts/mcp_client.py`, `scripts/uninstall.py` (Python 3.10+, standard
+library only, no dependency installation, no lifecycle hooks). Summarize the
+network, credential, local-state, telemetry, and self-update behavior listed
+under [Security & Safety Notes](#security--safety-notes).
+
+### Step 3: Copy in and disable self-update before any other command
+
+Ask for a **second, separate** approval, because this changes agent
+configuration. Then copy the reviewed tree to the host's skills directory
+(Claude Code shown; use the equivalent path for other hosts) and immediately
+turn off silent self-update for that exact path:
+
+```bash
+dest="$HOME/.claude/skills/talking-avatar-video"
+test ! -e "$dest" || { echo "destination exists; stop and ask the user"; exit 1; }
+cp -R talking-avatar-video "$dest"
+python3 "$dest/scripts/mcp_client.py" update --auto off
+```
+
+The last command must print
+`Automatic Beatra package updates are disabled.` It writes only
+`~/.beatra/updates/<id>/state.json` and makes no network request. Run it
+before `authorize.py`, `verify`, `tools`, `upload`, or `call`: in this
+pinned version self-update is **on by default**. The setting is keyed to the
+resolved install path, so repeat it after moving or re-copying the directory.
+
+### Step 4: Authorize as its own decision
+
+Authorization opens a browser sign-in and stores a bearer token. Ask first.
+
+```bash
+python3 "$dest/scripts/authorize.py"
+```
+
+Start a new agent session if the host discovers skills only at startup.
+
+## How It Works
+
+1. Read the installed package's `SKILL.md` and its references; they define the
+   routes, payload shapes, and review loop.
+2. Use free, non-billable discovery first (`beatra.models.list`, task list) to
+   read current model cards and credit estimates.
+3. Show the user a cost card for exactly one paid call: tool, model, estimate,
+   and which files will be uploaded. Wait for explicit approval. Planning or
+   "just do it" is not approval.
+4. Upload only files the user supplied and approved for this task, then submit
+   once with a stable `client_request_id` and poll the returned task.
+5. Report the delivered artifact and `billing.net_charged_credits`, review the
+   result with the user, and ask again before any further paid stage.
+
+## Examples
+
+### Free connection check (non-billable)
+
+```bash
+python3 "$HOME/.claude/skills/talking-avatar-video/scripts/mcp_client.py" verify
+```
+
+### One approved paid call
+
+After the user approved the cost card for this exact payload, submit once with
+a stable request id using the tool name from the installed `SKILL.md`. If the
+response is lost, retry only with the same `client_request_id` and identical
+arguments; never submit a replacement while the task is running.
+
+## Update
+
+This entry does not endorse the package's silent self-update. Keep
+`update --auto off` in place and do not run `update --auto on` or a bare
+`update` without explicit approval.
+
+To move to a newer version, repeat Steps 1 to 3 for that version in a new
+review directory, verify its digest against the matching tree in `beatra-ai/talking-avatar-video-skill`
+(a version not listed in this entry has not been reviewed here), show the
+user the file-level changes against the installed copy, and replace the
+directory only after approval. `update --check` reports the available version
+from `beatra.ai` without changing files.
+
+## Uninstall
+
+```bash
+dest="$HOME/.claude/skills/talking-avatar-video"
+python3 "$dest/scripts/uninstall.py" --dry-run
+python3 "$dest/scripts/uninstall.py"
+```
+
+Read the JSON decision. `disconnected` means this was the last Beatra skill on
+the device: the token was revoked (when `revoked` is `true`) and the files
+`credentials.json`, `installation.json`, `host.json`, `skills.json`, and
+`registrations.json` under `~/.beatra` were removed. `keep_connection` means
+another Beatra skill still uses the shared token, which stays. Then, after
+confirming the path with the user, delete `$dest`.
+
+`uninstall.py` does not remove `~/.beatra/updates/`. When the decision is
+`disconnected` and no other Beatra skill is installed, remove that directory
+too; otherwise leave it. A token that could not be revoked expires after 15
+days idle and can be revoked at once in the Beatra Console under Agents.
+
+## Best Practices
+
+- ✅ Keep one approval per paid call, per upload set, and per install step.
+- ✅ Report net charged credits from the terminal task, not the estimate.
+- ❌ Do not re-enable self-update or install an unreviewed version silently.
+- ❌ Do not print, paste, or move the token out of `~/.beatra/credentials.json`.
+- ❌ Do not retry a paid call with a new request ID after an uncertain response.
+
+## Limitations
+
+- Requires a Beatra account, network access, Python 3.10+, and prepaid credits.
+- Models, prices, schemas, and availability are controlled by Beatra and its
+  upstream model providers and can change; the service is provided as is.
+- Outputs are probabilistic, not guaranteed unique or non-infringing, and need
+  human review before publication.
+- This catalog entry reviews only the pinned archive above. A newer version is
+  a different review.
+
+## Security & Safety Notes
+
+`risk: critical` is deliberate.
+
+- **Network.** Authorization uses `api.beatra.ai`; every tool call and upload
+  goes to `mcp.beatra.ai`. With self-update left on, the client also fetches
+  `https://beatra.ai/skills/talking-avatar-video/install.json` and archives from
+  `cdn.beatra.ai`.
+- **Self-update (on by default in this pinned version).** Before `verify`,
+  `tools`, `upload`, or `call`, the client checks for a newer release at most
+  once every 24 hours and, if one exists, replaces package-owned files without
+  per-update preview or approval. It pins host and path, verifies checksums
+  from Beatra's own discovery document and CDN, and rolls back on failure, but
+  those digests are not independently anchored. This entry therefore requires
+  `update --auto off` before first use, as in Step 3.
+- **Uploads and third parties.** Prompts and uploaded media are sent to Beatra
+  and forwarded to the third-party model provider executing the task. Beatra
+  is hosted outside mainland China. See the
+  [privacy policy](https://beatra.ai/en/privacy).
+- **Likeness and reference media.** Uploaded portraits or reference clips are sent to Beatra and the model provider. Require approval for that exact file set.
+- **Billing.** Paid tools consume prepaid credits. Credits for tasks that fail
+  for reasons attributable to Beatra or the upstream model are returned
+  automatically; otherwise purchases are non-refundable, and actual usage can
+  exceed the estimate and leave a negative balance. See the
+  [terms](https://beatra.ai/en/terms).
+- **Credentials.** `authorize.py` runs an OAuth device flow, opens the browser,
+  and stores one bearer token in `~/.beatra/credentials.json` (directory
+  `0700`, file `0600`). The token never goes into argv, environment variables,
+  or output. It carries full Beatra scope, including `wallet:spend`, has a
+  sliding 15-day idle lifetime, and is shared by every Beatra skill on the
+  device.
+- **Local state.** `~/.beatra/` also holds `installation.json` (random
+  installation reference), `host.json` (agent platform and hostname),
+  `skills.json` (installed Beatra skill paths), `registrations.json`, and
+  `updates/<id>/state.json` plus update backups when updates run.
+- **Telemetry.** The device flow sends the hostname as the device name, the
+  package slug and version, and the detected agent platform (for example
+  `claude-code`, from environment variables). On first use the client makes a
+  non-billable `beatra.installations.register` call, and every tool call adds
+  `source_package_slug` and `source_platform`. There is no opt-out for these
+  fields.
+- **Retention.** Account data is kept for the life of the account. Task
+  records, artifacts, and billing ledgers are retained after account closure
+  for audit and tax purposes.
+- **Content rights.** Users keep rights in their inputs and receive Beatra's
+  rights in outputs; they must hold rights to uploaded media and must not
+  create deceptive impersonations.
+
+## Additional Resources
+
+- [Source tree at the pinned commit](https://github.com/beatra-ai/talking-avatar-video-skill/tree/251c968deebb1c8f1dbfd0a8404e8e1be1528ac6/skills/talking-avatar-video)
+- [Product page](https://beatra.ai/skills/talking-avatar-video)
+- [Terms](https://beatra.ai/en/terms) and [privacy policy](https://beatra.ai/en/privacy)

package/bundled-skills/tax-register/SKILL.md

@@ -0,0 +1,363 @@
+---
+name: tax-register
+description: 'Tax register: sales and purchase tax, withholding deducted and received, net payable, filing due date and days remaining. Use for tax compliance.'
+category: business
+risk: safe
+source: self
+source_type: self
+date_added: "2026-09-26"
+author: WHOISABHISHEKADHIKARI
+tags: [sme, business, operations, database, csv, notion, sql, protect]
+tools: []
+source_repo: WHOISABHISHEKADHIKARI/sme-ops-system-builder
+---
+
+# Tax Register
+
+**What it is:** Tax collected, tax paid, withholding and filing deadlines per period.
+
+## Overview
+
+Works out the smallest useful **Tax Register** setup for the business in front of it, then
+builds it only when asked. The default output is a short recommendation, not a
+spreadsheet. Artifacts - CSV, SQL DDL, JSON Schema, Notion mapping - are produced on
+request, from one field list so they cannot drift apart.
+
+Layer: Layer 7: Protect. Fits: Starter stage. Table code: n/a.
+
+## When to Use This Skill
+
+- tax register
+- gst tracker
+- vat records
+- tax filing calendar
+
+Also use it when the user says "tax collected, tax paid, withholding and filing deadlines per period", or describes the same process happening in a
+spreadsheet, a document or someone inboxes.
+
+Do not use it for: payroll calculation, tax filing, or legal advice. This skill produces
+empty templates only - it never holds or processes real employee or customer data.
+
+## How It Works
+
+Follow the shared execution contract. The module-specific rules below define only domain fields, decisions, calculations, and safety constraints.
+
+### Step 1 - Identify intent
+
+Read the request and pick the intent before asking anything.
+
+- "set up" or "build" or "create" -> the user wants artifacts; go to Step 2.
+- "our process is ..." or "it is in a sheet" -> the user wants to move an existing process; capture it, then Step 2.
+- "is this right" or "review" or "audit" -> the user wants a check, not a build; answer from what they share.
+- "how do I ..." -> advice question; answer directly and offer the build only if it helps.
+
+Ask only if this is the highest-value missing fact; otherwise proceed without an opener:
+
+> **Q:** Which taxes are you registered for?
+
+### Step 2 - Ask only what is missing
+
+Skip anything the user already answered, in any earlier message. Ask the rest one at a
+time, and stop as soon as the remaining answers would not change the output.
+
+- **Taxes** - Which taxes? / How many periods? / Which entities?
+- **Data** - Invoice data available? / Where is it? / Any missing receipts?
+- **Filing** - Who files? / Internal or accountant? / Deadlines recurring?
+- **Current process** - Is it tracked now? / Accountant or spreadsheet? / What gets missed?
+- **Outcome** - What do you need? / A register, a data extract or both?
+
+Never invent an answer. If the user does not know, record it as unknown and carry on.
+
+### Step 3 - Hold the internal context
+
+Hold the answers in this shape. It stays internal - it is not shown to the user unless
+they ask, and it never carries a value the user did not give.
+
+```yaml
+module: tax-register
+intent: null            # setup | advice | review | fix | build | convert | export
+scale: null             # Starter | Growth | Scale, only if the answer changes it
+areas:
+  "Taxes": null
+  "Data": null
+  "Filing": null
+  "Current process": null
+  "Outcome": null
+requested_outputs: []   # csv | sql | json | notion | xlsx - requested formats only
+confirmed_facts: []     # only what the user actually said
+open_questions: []      # the unanswered ones, in the order worth asking
+```
+
+### Step 4 - Recommend the smallest workflow
+
+If an artifact was requested, build it after resolving essential missing facts. Otherwise give a short recommendation and offer the relevant artifact.
+
+**Recommended approach:** Keep the tax register as a record of periods, amounts and filing status, and let the accountant or filing tool do the calculation.
+
+**Why this one:** Tax mistakes are calculation errors, and calculations belong in software. This should hold the record and the status, not the arithmetic.
+
+**Workflow:** Period opened → Source data recorded → Amount entered → Filed → Reconciled
+
+### Step 5 - Build only on request
+
+Once the user asks for it, derive the fields from the confirmed context and emit the
+requested artifacts. For machine-readable text, keep prose outside the data; for files,
+provide a usable link. Report material validation failures or limitations separately.
+
+**A selected Notion output is rendered by `notion-manual-import`, so route the
+Notion step there.** When the user selects Notion, hand that step to
+@notion-manual-import: it holds the CSV, the property
+mapping, the import steps and the verification checklist, and it renders the Field
+Reference below instead of defining a table of its own. Do not restate the mapping
+here and do not improvise the import steps. Manual CSV and mapping outputs need no
+connection. For requested workspace changes, follow the shared contract: verify actual
+tool access and the target before writing. A user saying "connected" is not tool evidence.
+Never ask for a Notion password or token.
+
+For an Excel-compatible CSV, use UTF-8 with a byte order mark so Excel opens the
+text correctly. A CSV is not an `.xlsx` workbook; create `.xlsx` only when the user
+requests a workbook.
+A CSV carries no types, so after it, name the columns
+that need a number, date or currency format applied.
+
+```csv
+Tax Record,Tax Type,Tax Period,Period Start,Period End,Tax Collected on Sales,Tax Paid on Purchases,Withholding Tax Deducted,Withholding Tax Paid to Us,Net Tax Payable,Currency,Filing Due Date,Filed Date,Payment Date,Filing Reference,Prepared By,Reviewed By,Days to Due,Status,Notes,Tax ID
+TAX-2026-03,GST,2026-03,2026-03-01,2026-03-31,354000.00,82000.00,2700.00,2700.00,272000.00,INR,2026-01-15,2026-01-15,2026-01-15,TAX-2026-03-Q1,Ananya Rao,Sneha Iyer,21,Filed,Filed with the accountant; working papers saved.,
+```
+
+```sql
+CREATE TABLE tax_register (
+  tax_record VARCHAR(255),
+  tax_type VARCHAR(100) NOT NULL,
+  tax_period VARCHAR(255),
+  period_start DATE NOT NULL,
+  period_end DATE NOT NULL,
+  tax_collected_on_sales NUMERIC(14,2) NOT NULL,
+  tax_paid_on_purchases NUMERIC(14,2) NOT NULL,
+  withholding_tax_deducted NUMERIC(14,2) NOT NULL,
+  withholding_tax_paid_to_us NUMERIC(14,2) NOT NULL,
+  net_tax_payable NUMERIC(14,2) NOT NULL,
+  currency VARCHAR(255),
+  filing_due_date DATE NOT NULL,
+  filed_date DATE NOT NULL,
+  payment_date DATE NOT NULL,
+  filing_reference VARCHAR(255),
+  prepared_by VARCHAR(255),
+  reviewed_by VARCHAR(255),
+  days_to_due NUMERIC NOT NULL,
+  status VARCHAR(100) NOT NULL,
+  notes TEXT,
+  tax_id SERIAL PRIMARY KEY,
+  created_at TIMESTAMP DEFAULT NOW(),
+  updated_at TIMESTAMP DEFAULT NOW()
+);
+
+CREATE INDEX idx_tax_register_status ON tax_register (status);
+```
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Tax Register",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+      "Tax Record": { "type": "string" },
+      "Tax Type": { "type": "string" },
+      "Tax Period": { "type": "string" },
+      "Period Start": { "type": "string", "format": "date" },
+      "Period End": { "type": "string", "format": "date" },
+      "Tax Collected on Sales": { "type": "number" },
+      "Tax Paid on Purchases": { "type": "number" },
+      "Withholding Tax Deducted": { "type": "number" },
+      "Withholding Tax Paid to Us": { "type": "number" },
+      "Net Tax Payable": { "type": "number" },
+      "Currency": { "type": "string" },
+      "Filing Due Date": { "type": "string", "format": "date" },
+      "Filed Date": { "type": "string", "format": "date" },
+      "Payment Date": { "type": "string", "format": "date" },
+      "Filing Reference": { "type": "string" },
+      "Prepared By": { "type": "string" },
+      "Reviewed By": { "type": "string" },
+      "Days to Due": { "type": "number" },
+      "Status": { "type": "string" },
+      "Notes": { "type": "string" },
+      "Tax ID": { "type": "integer" }
+  },
+  "required": [
+      "Tax Type",
+      "Period Start",
+      "Period End",
+      "Tax Collected on Sales",
+      "Tax Paid on Purchases",
+      "Withholding Tax Deducted",
+      "Withholding Tax Paid to Us",
+      "Net Tax Payable",
+      "Filing Due Date",
+      "Filed Date",
+      "Payment Date",
+      "Days to Due",
+      "Status"
+  ]
+}
+```
+
+```markdown
+| CSV column | Notion property | Set after import |
+|---|---|---|
+| Tax Record | Title | Use as the database title |
+| Tax Type | Select (add options after import) | Convert to Select, add options: "GST", "VAT", "TDS", "TCS", "Service Tax", "Income Tax", "Withholding" |
+| Tax Period | Text | Leave as Text |
+| Period Start | Date | Convert to Date |
+| Period End | Date | Convert to Date |
+| Tax Collected on Sales | Number (format: currency) | Convert to Number, set format to Currency |
+| Tax Paid on Purchases | Number (format: currency) | Convert to Number, set format to Currency |
+| Withholding Tax Deducted | Number (format: currency) | Convert to Number, set format to Currency |
+| Withholding Tax Paid to Us | Number (format: currency) | Convert to Number, set format to Currency |
+| Net Tax Payable | Number (format: currency) | Convert to Number, set format to Currency |
+| Currency | Text | Leave as Text |
+| Filing Due Date | Date | Convert to Date |
+| Filed Date | Date | Convert to Date |
+| Payment Date | Date | Convert to Date |
+| Filing Reference | Text | Leave as Text |
+| Prepared By | Text | Leave as Text |
+| Reviewed By | Text | Leave as Text |
+| Days to Due | Number | Convert to Number |
+| Status | Select (add options after import) | Convert to Select, add options: "Draft", "Filed", "Paid", "Overdue", "Amended" |
+| Notes | Text | Leave as Text |
+| Tax ID | Text (preserve source ID) | Keep imported IDs as Text; optionally add a separate Unique ID property |
+```
+
+The rows above are documentation examples only. Emit empty templates unless the user explicitly requests examples. Money stays `currency`, dates stay `date`,
+and anything pointing at another table stays `relation`.
+
+## Field Reference
+
+| # | Field | Type | SQL | JSON Schema | Notion | CSV example |
+|---:|---|---|---|---|---|---|
+| 1 | Tax Record | `text` | `VARCHAR(255)` | `string` | Text | `TAX-2026-03` |
+| 2 | Tax Type | `select` | `VARCHAR(100)` | `string` | Select (add options after import) | `GST` |
+| 3 | Tax Period | `text` | `VARCHAR(255)` | `string` | Text | `2026-03` |
+| 4 | Period Start | `date` | `DATE` | `string, format: date` | Date | `2026-03-01` |
+| 5 | Period End | `date` | `DATE` | `string, format: date` | Date | `2026-03-31` |
+| 6 | Tax Collected on Sales | `currency` | `NUMERIC(14,2)` | `number` | Number (format: currency) | `354000.00` |
+| 7 | Tax Paid on Purchases | `currency` | `NUMERIC(14,2)` | `number` | Number (format: currency) | `82000.00` |
+| 8 | Withholding Tax Deducted | `currency` | `NUMERIC(14,2)` | `number` | Number (format: currency) | `2700.00` |
+| 9 | Withholding Tax Paid to Us | `currency` | `NUMERIC(14,2)` | `number` | Number (format: currency) | `2700.00` |
+| 10 | Net Tax Payable | `currency` | `NUMERIC(14,2)` | `number` | Number (format: currency) | `272000.00` |
+| 11 | Currency | `text` | `VARCHAR(255)` | `string` | Text | `INR` |
+| 12 | Filing Due Date | `date` | `DATE` | `string, format: date` | Date | `2026-01-15` |
+| 13 | Filed Date | `date` | `DATE` | `string, format: date` | Date | `2026-01-15` |
+| 14 | Payment Date | `date` | `DATE` | `string, format: date` | Date | `2026-01-15` |
+| 15 | Filing Reference | `text` | `VARCHAR(255)` | `string` | Text | `TAX-2026-03-Q1` |
+| 16 | Prepared By | `text` | `VARCHAR(255)` | `string` | Text | `Ananya Rao` |
+| 17 | Reviewed By | `text` | `VARCHAR(255)` | `string` | Text | `Sneha Iyer` |
+| 18 | Days to Due | `number` | `NUMERIC` | `number` | Number | `21` |
+| 19 | Status | `select` | `VARCHAR(100)` | `string` | Select (add options after import) | `Filed` |
+| 20 | Notes | `long_text` | `TEXT` | `string` | Text | `Filed with the accountant; working papers saved.` |
+| 21 | Tax ID | `id` | `SERIAL PRIMARY KEY` | `integer` | Text (preserve source ID) | `(blank)` |
+
+## Select Options
+
+**Tax Type**
+
+```
+GST | VAT | TDS | TCS | Service Tax | Income Tax | Withholding
+```
+**Status**
+
+```
+Draft | Filed | Paid | Overdue | Amended
+```
+
+## Relations
+
+Link fields: none
+
+## Examples
+
+**Prompt**
+
+```
+Our accountant asks for figures every quarter and we assemble them manually.
+```
+
+**Context first** - one question per message, nothing already answered:
+
+> **Q:** Which taxes?
+> **A:** VAT and corporation tax.
+>
+> **Q:** Who files?
+> **A:** Our accountant.
+>
+> **Q:** Source data?
+> **A:** Invoices, but not consistently.
+
+**Recommended next step** - offered, not built:
+
+> Keep the tax register as a record of periods, amounts and filing status, and let the accountant or filing tool do the calculation.
+>
+> Workflow: Period opened → Source data recorded → Amount entered → Filed → Reconciled
+>
+> Want the CSV, SQL, JSON Schema and Notion mapping for this?
+
+## Best Practices
+
+- Build when requested; recommend and offer a build for advice-only requests.
+- One question per message. A batched intake reads as a form and gets guessed at.
+- Keep display names identical across CSV and JSON; document normalized SQL identifiers.
+- Use `relation` for anything that points at another table, `text` only for free text.
+- Money fields are `currency`, never `text`. Dates are `date`, never free text.
+- If the user requests an example row, keep it obviously fake so nobody imports it as real data.
+
+## Limitations
+
+- Empty template only. It does not compute payroll, tax, leave balances or KPIs.
+- Notion relations need both databases imported before the link column resolves.
+- Select options are a starting set. Rename them to match how the business talks.
+- No automation, reminders or sync. Those need the integration layer.
+- Does not calculate tax, file returns or give tax advice.
+- Legal, tax and HR review is still required before this drives real decisions.
+
+## Security & Safety Notes
+
+- Never fill in real names, salaries, medical or banking data. Placeholders only.
+- Label example rows as synthetic, and keep bank details masked.
+- Local reads, generation commands, and validation are part of a requested artifact build.
+  External writes, messages, provisioning, and publication require authorization for that
+  action and target; existing explicit authorization does not need to be repeated.
+- If sensitive data is supplied, avoid repeating unnecessary identifiers. Use only what
+  the requested review needs; keep generated templates empty. Do not claim deletion
+  from the conversation or service storage.
+- Privacy, legal and disciplinary cases need a qualified human reviewer before anything
+  is acted on.
+
+## Common Pitfalls
+
+- **Problem:** a static mapping is described as a completed workspace build.
+  **Solution:** deliver manual mappings without a connection; claim a live change only
+  after the authorized tool operation succeeds.
+- **Problem:** asked all six questions in one message.
+  **Solution:** ask one, wait, and drop any the first answer already covered.
+- **Problem:** built a full system when one table was asked for.
+  **Solution:** build what was requested; mention the parent skill separately.
+- **Problem:** all four artifacts drift apart.
+  **Solution:** derive all four from the field list in this file, never by hand.
+- **Problem:** Notion import shows every column as Text.
+  **Solution:** that is expected. Apply the property mapping table once, after import.
+
+## Related Skills
+
+- [Module Catalog](https://github.com/sickn33/agentic-awesome-skills/blob/main/CATALOG.md) - find the relevant module, then read its skill.
+- @people-directory - the employee master record most modules link to.
+- @notification-reminder-hub - turns due dates in this module into reminders.
+
+## Reusable Prompt
+
+```
+I want to set up tax collected, tax paid, withholding and filing deadlines per period for my company.
+Ask me one short question at a time, and only about what I have not already told you.
+Then recommend the smallest setup that fits, and wait for me to ask before you build it.
+When I ask, output CSV, SQL DDL, JSON Schema, a Notion property mapping or an Excel workbook. Data only.
+```
+