{"id":51282345,"url":"https://github.com/nijanthan-dev/taxmate-australia","last_synced_at":"2026-06-30T03:00:32.019Z","repository":{"id":366813684,"uuid":"1277937786","full_name":"nijanthan-dev/taxmate-australia","owner":"nijanthan-dev","description":"Australian tax prep skills linked to official ATO sources for Codex, Claude Code, and Cowork: GST/BAS, CGT, evidence gaps, and accountant handoff.","archived":false,"fork":false,"pushed_at":"2026-06-30T02:48:49.000Z","size":4767,"stargazers_count":1,"open_issues_count":14,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-30T03:00:21.113Z","etag":null,"topics":["abn","accountant","ato","australian-tax","bas","cgt","claude-code","codex","codex-plugin","cowork","fbt","gst","openagentskill","payg","sole-trader","superannuation","tax-prep","tax-records"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nijanthan-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-06-23T10:14:14.000Z","updated_at":"2026-06-30T01:12:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/nijanthan-dev/taxmate-australia","commit_stats":null,"previous_names":["nijanthan-dev/taxmate-au","nijanthan-dev/taxmate-australia"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nijanthan-dev/taxmate-australia","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nijanthan-dev%2Ftaxmate-australia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nijanthan-dev%2Ftaxmate-australia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nijanthan-dev%2Ftaxmate-australia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nijanthan-dev%2Ftaxmate-australia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nijanthan-dev","download_url":"https://codeload.github.com/nijanthan-dev/taxmate-australia/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nijanthan-dev%2Ftaxmate-australia/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34950330,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-30T02:00:05.919Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["abn","accountant","ato","australian-tax","bas","cgt","claude-code","codex","codex-plugin","cowork","fbt","gst","openagentskill","payg","sole-trader","superannuation","tax-prep","tax-records"],"created_at":"2026-06-30T03:00:22.380Z","updated_at":"2026-06-30T03:00:32.013Z","avatar_url":"https://github.com/nijanthan-dev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TaxMate Australia\n\nTaxMate Australia is an Australian tax prep skill pack and plugin linked to official ATO sources for conservative record review, GST/BAS and CGT triage, evidence gaps, accountant-ready workbook/taxpack handoff, ATO-aligned manual guide PDFs, and treatment flags across Codex, Claude Code, Cowork, and OpenAgentSkill CLI.\n\n\u003e [!WARNING]\n\u003e **Not tax advice.** TaxMate Australia is a preparation aid, not professional advice or lodgment software. For complex situations, binding decisions, or lodgment, consult a registered tax agent or use the official ATO channel directly. See [DISCLAIMER.md](DISCLAIMER.md).\n\n## Choose Your Install\n\nPick the smallest path that matches what you need:\n\n| Need | Install | What you get |\n| --- | --- | --- |\n| Quick use in Codex, Claude Code, Cowork, or OpenAgentSkill CLI | Portable skills | Topic guidance, source-backed review prompts, and `Accountant review` flags. No checkout required. |\n| HTML guide, workbook/taxpack output, source refresh, finance review, calculators, or validation | Full runtime checkout | Bash + Python runtime, source pipeline, guide generation, and audit tooling. |\n| Development, CI, or local plugin testing | Full runtime checkout + dev checks | Same runtime plus publication checks and local plugin metadata validation. |\n\nFast portable install:\n\n```bash\nnpx skills@1.5.13 add nijanthan-dev/taxmate-australia --list\nnpx skills@1.5.13 add nijanthan-dev/taxmate-australia \\\n  --agent codex --global --skill '*' --yes\n```\n\nPortable details: [docs/INSTALLATION.md](docs/INSTALLATION.md).\nFull runtime details: [docs/FULL_PLUGIN_INSTALL.md](docs/FULL_PLUGIN_INSTALL.md).\n\n## Preview\n\n![Example TaxMate Australia self-prepared guide output for synthetic John Doe data](assets/readme/taxmate-guide-john-doe.png)\n\nExample guide from synthetic John Doe data. Shows interview answers, source-backed evidence prompts, and `Accountant review` flags. Not an ATO form. Not fileable.\n\n![Example TaxMate Australia manual-copy worksheet for synthetic John Doe data](assets/readme/taxmate-guide-john-doe-worksheet.png)\n\nThe worksheet page shows manual-copy rows, source provenance, evidence prompts, and `Accountant review` flags.\n\n## What It Does\n\n- Reviews Australian tax prep records for employees, ABN/sole-trader work, investments, rental property, crypto, superannuation, and private health.\n- Keeps ATO source URLs, checked-at dates, source coverage checks, and generated topic skills visible.\n- Flags GST/BAS, PAYG, FBT, CGT, super guarantee, and stamp-duty source-routing items for conservative review.\n- Builds accountant-facing workbook and taxpack outputs from reviewed data.\n- Creates ATO-aligned manual guide PDFs that help users copy reviewed answers into myTax, paper ATO forms, or an accountant handoff. TaxMate does not fill official ATO PDFs or create returns users can submit directly to the ATO.\n\n## Full Runtime Quickstart\n\nUse this path when you need generated guides, workbook/taxpack outputs, source refresh, finance review, calculators, validation, or local plugin testing.\n\nPrerequisites:\n\n- Node.js 20 or newer.\n- Bash, Python 3.9+, Git, curl, and jq.\n- Codex for full plugin workflows; Claude Code, Cowork, or OpenAgentSkill CLI for portable skill workflows.\n\nClone and bootstrap:\n\n```bash\ngit clone https://github.com/nijanthan-dev/taxmate-australia.git\ncd taxmate-australia\nbash scripts/bootstrap-dev-env.sh\n```\n\nValidate the checkout:\n\n```bash\n./scripts/taxmate validate\n./scripts/taxmate skills generate --check\n```\n\nFull setup details: [docs/FULL_PLUGIN_INSTALL.md](docs/FULL_PLUGIN_INSTALL.md).\n\n## Use It\n\nAsk for a specific portable skill when the topic is clear:\n\n```text\nUse the individual-return skill to build a V1 individual return checklist with ABN and BAS review queues.\n```\n\n```text\nUse the capital-gains-tax skill to review this disposal conservatively.\n```\n\n```text\nUse the gst-bas skill to identify missing evidence and accountant-review items.\n```\n\n```text\nUse the work-from-home skill for the 2025-26 income year and verify current rates before calculating anything.\n```\n\nRun full-runtime commands from a checkout:\n\n```bash\n./scripts/taxmate skills generate\n./scripts/taxmate refresh --query \"payg\"\n./scripts/taxmate intake individual --help\n./scripts/taxmate finance --help\n```\n\nCreate a self-prepared HTML guide users can save as PDF from their browser:\n\n```bash\n./scripts/taxmate taxpack sample-json --output /tmp/taxmate-guide-input.json\n./scripts/taxmate taxpack guide-html \\\n  --input /tmp/taxmate-guide-input.json \\\n  --output /tmp/taxmate-guide.html\n```\n\nOpen the HTML in a browser and use print/save as PDF. The printed PDF keeps the same guide layout and hides the preview toolbar. Rows can include `source_url`, `source_urls`, and `checked_at`; the guide keeps those provenance fields visible in the worksheet.\n\n## Skills Included\n\nPublic portable entry points:\n\n- `taxmate-australia`\n- `individual-return`\n- `employment-deductions`\n- `work-from-home`\n- `abn-business`\n- `gst-bas`\n- `payg-employer`\n- `capital-gains-tax`\n- `shares-etfs-managed-funds`\n- `crypto-assets`\n- `property-rental-cgt`\n- `superannuation`\n- `private-health-medicare`\n- `records-evidence`\n- `workbook`\n- `taxpack`\n\nSource artifacts are tracked in `data/ato_knowledge_base/source_coverage.json`, derived from `data/ato_knowledge_base/source_registry.json`.\n\n## Development\n\nCore checks:\n\n```bash\nPYTHONPYCACHEPREFIX=/tmp/taxmate-pycache python3 -m py_compile scripts/*.py\n./scripts/taxmate validate\n./scripts/taxmate skills generate --check\n./scripts/taxmate skills audit --check\nscripts/check-publication-ready.sh\n```\n\nContributor flow and release checks: [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md).\n\n## Troubleshooting\n\n- `npx: command not found`: install Node.js. Portable skills need Node.js 18 or newer; full-runtime workflows need Node.js 20 or newer.\n- Plugin command not working: re-run `bash scripts/bootstrap-dev-env.sh` and verify `python3` + `bash` are available.\n- Need portable-only access: use [docs/INSTALLATION.md](docs/INSTALLATION.md), not the full checkout path.\n\n## More Docs\n\n- Full plugin setup: [docs/FULL_PLUGIN_INSTALL.md](docs/FULL_PLUGIN_INSTALL.md)\n- Optional portable install: [docs/INSTALLATION.md](docs/INSTALLATION.md)\n- Development: [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md)\n- Discovery metadata: [docs/DISCOVERY.md](docs/DISCOVERY.md)\n- Skill generation: [docs/SKILL_GENERATION.md](docs/SKILL_GENERATION.md)\n- Disclaimer: [DISCLAIMER.md](DISCLAIMER.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnijanthan-dev%2Ftaxmate-australia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnijanthan-dev%2Ftaxmate-australia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnijanthan-dev%2Ftaxmate-australia/lists"}