Imported from zackwag/opa-ai (AGENTS.md). Install upstream with npx skills add zackwag/opa-ai. Copyright stays with the author.

AGENTS.md

Name: opa-ai
Author: zackwag

Project overview

opa-ai is a React + Vite web app that helps Philadelphia homeowners appeal their property tax assessment: it finds comparable, lower-assessed nearby homes via the City of Philadelphia's public OPA/Carto SQL API and generates an appeal PDF. No API key required.

Setup

npm install

Build / Run

npm run dev      # Vite dev server
npm run build     # production build
npm run preview   # preview the production build

Also runnable via Docker — see Dockerfile and nginx.conf.

Test

npm test

Runs vitest run. Test files are colocated in src/ (*.test.js).

Lint / Format

npm run lint

Runs oxlint.

Repository structure

src/App.jsx — main app component
src/api.js — Carto SQL API client
src/PropertyMap.jsx — Leaflet map of property + comps
src/generatePdf.js — jsPDF appeal report generation
src/AddressAutocomplete.jsx, src/Tooltip.jsx — UI components
src/glossary.js, src/fields.json — assessment field metadata
public/ — static assets

Commit and PR conventions

Commit messages and PR titles must follow Conventional Commits (feat:, fix:, docs:, chore:, refactor:, test:, ci:, build:, perf:, style:, revert:), optionally with a scope, e.g. fix(api): handle null response.
This repo squash-merges pull requests only; the PR title becomes the final commit message on main.
A "Conventional Commits" CI check enforces this on both PR titles and direct-push commit messages.
Branch protection on main: no force-pushes, no branch deletion, required status checks must pass.

{ "ocm": "1", "id": "zackwag-opa-ai-opa-ai", "kind": "skill", "name": "opa-ai", "description": "opa-ai is a React + Vite web app that helps Philadelphia homeowners appeal their property tax assessment: it finds comparable, lower-assessed nearby homes via the City of Philadelphia's public OPA/Carto SQL API and generates an appeal PDF. No API key required.", "publisher": "zackwag", "version": "1.0.0", "capabilities": { "domains": [ "coding", "finance" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "opa-ai is a React + Vite web app that helps Philadelphia homeowners appeal their property tax assessment: it finds comparable, lower-assessed nearby homes via the City of Philadelphia's public OPA/Carto SQL API and generates an appeal PDF. No API key required." ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/zackwag/opa-ai", "path": "AGENTS.md", "ref": "3f8b2aa5d1a605ba4e01d28a9bfeadc0c8f29646", "url": "https://github.com/zackwag/opa-ai/blob/3f8b2aa5d1a605ba4e01d28a9bfeadc0c8f29646/AGENTS.md", "key": "zackwag/opa-ai/AGENTS.md" } }, "instructions": "# AGENTS.md\n\n## Project overview\n\nopa-ai is a React + Vite web app that helps Philadelphia homeowners appeal\ntheir property tax assessment: it finds comparable, lower-assessed nearby\nhomes via the City of Philadelphia's public OPA/Carto SQL API and generates\nan appeal PDF. No API key required.\n\n## Setup\n\n```\nnpm install\n```\n\n## Build / Run\n\n```\nnpm run dev # Vite dev server\nnpm run build # production build\nnpm run preview # preview the production build\n```\n\nAlso runnable via Docker — see `Dockerfile` and `nginx.conf`.\n\n## Test\n\n```\nnpm test\n```\n\nRuns `vitest run`. Test files are col", "cost": { "context_tokens": 419 } }

opa-ai

About

AGENTS.md

Project overview

Setup

Build / Run

Test

Lint / Format

Repository structure

Commit and PR conventions

Use it

Manifest

Reviews