[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77TNBPWN7EVSEQXTD1XWN19":3,"skill-same:01M77TNBPWN7EVSEQXTD1XWN19":47},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M77TNBPWN7EVSEQXTD1XWN19","sf-civic-digest",null,"Track San Francisco city government activity — Board of Supervisors, Land Use committee, Public Safety committee, SFMTA Engineering Public Hearings, SF Planning Commission, Historic Preservation Commission, Zoning Administrator hearings, Planning project notices, and SF.gov district events. Fetches agendas and recaps from SF Legistar, sfmta.com, sfplanning.org, the sf.gov Wagtail CMS API (api.sf.gov), and Socrata open data via curl-based scraping. Filtered by supervisorial district, neighborhood, streets, or topic keywords. Use when a user asks what's happening at City Hall, wants to track legislation or development in their neighborhood, wants a weekly or daily SF civic digest, asks about upcoming public hearings, planning variances, or wants to know what their supervisor is working on. SF-specific.","Lord1Egypt\u002Fawesome-skill-forge","Lord1Egypt","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F99746359?v=4","01M7592YDNT0XK9WJ0T2MQVPDN","Mohamed Mounir Ali AL Keshita","01M75GRFNHC8VZNWEB8DKDE433",3,"MIT","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fs\u002Fsf-civic-digest\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: sf-civic-digest\ndescription: Track San Francisco city government activity — Board of Supervisors, Land Use committee, Public Safety committee, SFMTA Engineering Public Hearings, SF Planning Commission, Historic Preservation Commission, Zoning Administrator hearings, Planning project notices, and SF.gov district events. Fetches agendas and recaps from SF Legistar, sfmta.com, sfplanning.org, the sf.gov Wagtail CMS API (api.sf.gov), and Socrata open data via curl-based scraping. Filtered by supervisorial district, neighborhood, streets, or topic keywords. Use when a user asks what's happening at City Hall, wants to track legislation or development in their neighborhood, wants a weekly or daily SF civic digest, asks about upcoming public hearings, planning variances, or wants to know what their supervisor is working on. SF-specific.\n---\n\n# SF Civic Digest — SKILL.md\n\n> **Cold-start note:** This file is designed to be self-sufficient. An agent reading only SKILL.md should be able to run reports, generate digests, and understand the full data stack. No other context required.\n\n---\n\n## Quick Start\n\n```bash\n# Step 1: Find the absolute path to this skill's scripts\u002F directory\n#         (it's always a sibling of this SKILL.md file)\nSKILL_DIR=\"\u002Fabsolute\u002Fpath\u002Fto\u002Fsf-civic-digest\"\n\n# Step 2: Run scripts using that absolute path (--district N required)\npython3 \"$SKILL_DIR\u002Fscripts\u002Fsf_weekly_digest.py\" --district 5 --json\n\n# Step 3: Synthesize the JSON output into a narrative report (see STYLE.md)\n```\n\n**Note:** `sf_weekly_digest.py` makes ~22 network calls sequentially and can take 2-3 minutes. For a quick test, try a single script first: `python3 \"$SKILL_DIR\u002Fscripts\u002Fsf_journalism.py\" --district 5 --days 7 --json`\n\n**District:** Pass `--district N` (1–11) to any script. User preferences and neighborhood context live in `USER.md` — read it before writing a report. There is no `civic_config.json` or `civic_config.example.json`; those files have been removed.\n\n**⚠️ Path rule — critical for any agent (any agent, IDE, or human):**\n- All scripts must be run with the **absolute path to the scripts\u002F directory**\n- Find it: `scripts\u002F` is always a sibling of this SKILL.md file\n- Example: if SKILL.md is at `\u002Fhome\u002Falice\u002F.openclaw\u002Fworkspace\u002Fskills\u002Fsf-civic-digest\u002FSKILL.md`, then scripts are at `\u002Fhome\u002Falice\u002F.openclaw\u002Fworkspace\u002Fskills\u002Fsf-civic-digest\u002Fscripts\u002F`\n- **Never use bare relative paths like `scripts\u002Ffoo.py`** — they break when the working directory is anything other than the skill root\n- When in doubt: `realpath` on any script path gives you the absolute path\n\n---\n\n## Architecture\n\n**Scripts are data pipelines. The agent writes the narrative.**\n\nThe scripts fetch, parse, dedup, and output JSON. The agent (you) reads that JSON and synthesizes it into a report following the style guide. There is no auto-generated report — the editorial judgment is yours.\n\n```\nsf_weekly_digest.py --json\n    └── calls all subscripts → returns combined JSON\n            │\n            ▼\n    Agent reads JSON + STYLE.md\n            │\n            ▼\n    Agent writes narrative report\n```\n\nFor report generation, see **Report Generation** section below.\n\n---\n\n## All Scripts\n\n**Canonical script location:** `skills\u002Fsf-civic-digest\u002Fscripts\u002F`\n\n| Script | What it does | Method | Notes |\n|--------|-------------|--------|-------|\n| `sf_weekly_digest.py` | Master aggregator — calls all subscripts | — | Use `--json` for machine-readable output; pass to agent for synthesis |\n| `sf_civic_digest.py` | Board of Supervisors + all committees via Legistar | curl | `--daily` for delta only; `--days N`; state in `sf_civic_state.json` |\n| `sfmta_hearings.py` | SFMTA Engineering Public Hearings | curl + PDF | Street changes, parking meters, signals. Every ~2 weeks. |\n| `sf_planning_notices.py` | SF Planning project notices (Section 311) | curl | Earliest signal layer — before commission hearings. Needs `Accept: text\u002Fhtml` header. |\n| `sf_planning_commission.py` | Planning Commission, HPC, ZA full agendas | curl + PDF | Server-rendered HTML (no browser). `--body hpc` for HPC, `--body za` for ZA. |\n| `sf_board_of_appeals.py` | Board of Appeals | Wagtail API | sf.gov CMS API (`api.sf.gov`). 1st & 3rd Wednesdays, 5pm. No browser needed. |\n| `sf_building_permits.py` | Building permits citywide | Socrata REST | Every permit filed. Classified HIGH\u002FNOTABLE\u002Fnoise. State-tracked. |\n| `sfgov_events.py` | Supervisor office hours, district events | REST\u002FJSON | Very sparse — supervisor events only. Low signal. |\n| `sf_311.py` | 311 service requests by district | Socrata REST | Spike detection. Query two 7-day windows for trend comparison. |\n| `sf_ethics.py` | Lobbyist contacts + campaign contributions | RSS + Socrata | Contacts: `5f5n-tdbf`. Contributions: `e6py-fg8b`. Column names have NO underscores. |\n| `sf_rent_board.py` | Rent Board commission meetings | Wagtail API | sf.gov CMS API (`api.sf.gov`). No browser needed. Rent increase: links to sf.gov (no hardcoded value). |\n| `sf_sfmta_board.py` | SFMTA Board of Directors | curl | 1st & 3rd Tuesdays 1pm. Service changes, fare decisions, bike\u002Fped safety. |\n| `sf_rec_park.py` | Rec & Park Commission | curl (Granicus) | `view_id=91`. sfrecpark.org is unreachable from server — Granicus only. |\n| `sf_housing_pipeline.py` | AB 2011 \u002F SB 35 \u002F density bonus housing pipeline | Socrata REST | Cross-refs parcels dataset for district. Watchlist tracks 400 Divisadero. State-tracked. |\n| `sf_journalism.py` | News aggregator — 5 SF outlets | RSS | Mission Local, Streetsblog SF, SF YIMBY, 48 Hills, SF Standard. SF Examiner 404s. Archive: `sf_journalism_archive.json`. |\n| `sf_volunteer_cleanups.py` | Community cleanup events | curl\u002FJS bundle | Refuse Refuse SF + DPW Love Our City NBDs. GoDaddy SPA — data is in JS bundle, not HTML. |\n| `sf_bart_board.py` | BART Board of Directors + advisory bodies | Legistar API | `webapi.legistar.com\u002Fv1\u002Fbart\u002FEvents`. Board = HIGH, advisory = MEDIUM. `--next` for next meeting. |\n| `sf_sfusd_board.py` | SFUSD Board of Education meetings | Google Sheets + BoardDocs | 2nd & 4th Tuesdays 5pm. Falls back to projected schedule if sources unavailable. |\n| `sf_evictions.py` | Eviction notices by district | Socrata REST | Dataset `5cei-gny5`. Ellis Act + OMI = displacement signals. Trend comparison (two windows). `--district N`. |\n| `sf_sfcta.py` | SF County Transportation Authority | curl (sfcta.org) | Congestion pricing, Muni Forward, bike\u002Fped funding, Prop L sales tax. Board + CAC + committees. |\n| `sf_civic_actions.py` | Protests, rallies, civic actions | Mobilize.us API + Indybay | No auth. Rallies\u002Fmarches = HIGH, canvass\u002Fphone bank = MEDIUM. `--type rally` to filter. |\n| `sf_mission_local.py` | Mission Local news only | RSS | Subset of sf_journalism.py. Use sf_journalism.py for multi-outlet. |\n| `config_loader.py` | District config loader | — | All 11 districts pre-populated. Pass `--district N` to any script. |\n\n### No browser required\nAll scripts now work without a browser. `sf_board_of_appeals.py` and `sf_rent_board.py` use the sf.gov Wagtail CMS API (`api.sf.gov\u002Fapi\u002Fv2\u002Fpages\u002F`). `sf_planning_commission.py` uses curl against server-rendered Drupal HTML (the sfplanning.org calendar pages are not JS-dependent despite initial assumptions).\n\n---\n\n## District Configuration\n\nAll scripts accept `--district N` (1–11). That's all you need for a basic run.\n\nUser preferences and neighborhood context (streets, addresses, people to flag) live in **`USER.md`** — a human-readable profile file. There is no `civic_config.json`; that file has been removed. Read `USER.md` to understand what the user cares about before writing any report.\n\nDistrict→neighborhood mappings: `references\u002Fsf-districts.md`\nBuild timeline benchmarks: `references\u002Fsf-build-timelines.md` — **Read before writing about any housing project.** Includes typical phase durations, financing tracking methods, and context for whether a project is on track or stalled.\n\n---\n\n## Report Generation\n\n### Agent-driven (recommended for one-off reports)\n\n```bash\n# 1. Collect data (use absolute paths — see path rule above)\npython3 \u002Fabsolute\u002Fpath\u002Fto\u002Fsf-civic-digest\u002Fscripts\u002Fsf_weekly_digest.py --json > \u002Ftmp\u002Fcivic_data.json\npython3 \u002Fabsolute\u002Fpath\u002Fto\u002Fsf-civic-digest\u002Fscripts\u002Fsf_housing_pipeline.py --district 5 --json >> \u002Ftmp\u002Fcivic_data.json\npython3 \u002Fabsolute\u002Fpath\u002Fto\u002Fsf-civic-digest\u002Fscripts\u002Fsf_volunteer_cleanups.py --district 5 --days 14 --json >> \u002Ftmp\u002Fcivic_data.json\n\n# 2. Agent synthesizes following STYLE.md\n# Read STYLE.md, read the JSON, write narrative to reports\u002F\n```\n\n### Agent-driven reports (quarterly, annual, deep dives)\n\nGive your agent the workspace path and let it orchestrate:\n\n> Read STYLE.md and USER.md. Run the scripts in scripts\u002F to collect data for District 5, then write a Q1 2026 civic digest. Save to reports\u002F.\n\n**⚠️ Path gotcha:** Agents default to wrong relative paths. Always resolve the absolute path to `scripts\u002F` from the location of this SKILL.md before running anything. Use full absolute paths — e.g. `python3 \u002Ffull\u002Fpath\u002Fto\u002Fscripts\u002Fsf_housing_pipeline.py`. Never just `scripts\u002FSCRIPTNAME.py`.\n\n### Report style\nRead `STYLE.md` before writing any report. Key rules:\n- TLDR (5-7 bullets) first — last bullet is always one action\n- Officials box: YOUR elected officials only (supervisor, mayor, state reps)\n- Short sections (3-5 sentences), scan-and-skip\n- Connect threads across sources (lobbying + permits + 311 + journalism = one story)\n- End each thread with a specific action (date, email address, what to say)\n- Rates over counts. \"Up 15%\" beats \"95 reports.\"\n- Tone: pro-building, pro-tech, car-free lens. See STYLE.md for full framing guidance.\n\nReference: see `STYLE.md` for rules and examples.\n\n---\n\n## Key Data Gotchas\n\nThese will burn you if you don't know them:\n\n**Socrata column names:**\n- 311 (`vw6y-z8j6`): `supervisor_district` = `'5.0'` (float string), date field = `requested_datetime`\n- Building Permits (`i98e-djp9`): `supervisor_district` = `'5'`. Address split across `street_number`\u002F`street_name`\u002F`street_suffix` — no combined field. `estimated_cost` is a string, cast in Python.\n- Lobbyist Contacts (`5f5n-tdbf`): NO underscores — `officialname`, `clientname`, `lobbyistname`\n- Lobbyist Contributions (`e6py-fg8b`): same — `lobbyistname`, `candidatename`, `sourceoffunds`\n- Planning Records (`qvu5-m3a2`): `pim_link` returns `{\"url\": \"...\"}` dict, not string. No `supervisor_district` — cross-reference parcels (`acdm-wktn`) by `block`\u002F`lot`.\n\n**Legistar:** The API is broken for SF (returns \"Agenda Draft Status\" error). Use the RSS feed instead:\n`https:\u002F\u002Fsfgov.legistar.com\u002FFeed.ashx?M=C&ID=17442&GUID=EEE85B7C-1A1C-4A56-873E-355A0A0DE5C3&Mode=All&Format=rss`\nReturns ~100 meetings (~6 months). Parse meeting IDs from RSS, then `fetch_meeting_detail()` for agenda items.\n\n**Reddit:** Direct curl blocked (403, datacenter IP). Use `web_fetch` tool — routes differently, works.\n\n**sfrecpark.org:** Completely unreachable from this server. Granicus (`view_id=91`) is the only path.\n\n**311 trend pattern:** Query two 7-day windows (current + prior week) and show week-over-week delta. \"Encampments up 15%\" is useful. \"95 encampments\" is not.\n\n**Journalism archive:** `sf_journalism.py` persists articles to `sf_journalism_archive.json` (cap 2000). For quarterly history, use `--archive --days 90`.\n\n---\n\n## Socrata Dataset Reference\n\n| Dataset | ID | Key fields |\n|---------|-----|-----------|\n| Building Permits | `i98e-djp9` | permit_number, permit_type, address (split), supervisor_district ('5'), estimated_cost (string) |\n| 311 Cases | `vw6y-z8j6` | service_name, requested_datetime, supervisor_district ('5.0') |\n| Planning Dept Records | `qvu5-m3a2` | record_id, description, record_status, project_address, block, lot, number_of_units_net, pim_link (dict) |\n| SF Parcels | `acdm-wktn` | block_num, lot_num, supervisor_district, zoning_code |\n| Lobbyist Contacts | `5f5n-tdbf` | officialname, lobbyistname, clientname, outcomesought, subjectarea, filenumber |\n| Lobbyist Contributions | `e6py-fg8b` | lobbyistname, candidatename, sourceoffunds, committeename |\n| Assessor Parcels | `fk72-cxc3` | property_location, parcel_number, assessed_land_value, zoning_code |\n| Eviction Notices | `5cei-gny5` | eviction_id, address, neighborhood, file_date, supervisor_district, ellis_act_withdrawal, owner_move_in |\n\nQuery pattern: `https:\u002F\u002Fdata.sfgov.org\u002Fresource\u002F{id}.json?$where=supervisor_district='5'&$order=date+DESC&$limit=50`\n\n---\n\n## Scraping Method Reference\n\n| Site | curl works? | Browser needed? |\n|------|-------------|-----------------|\n| Legistar (sfgov.legistar.com) | ✅ | No |\n| SFMTA (sfmta.com) | ✅ | No |\n| SF Planning notices (sfplanning.org\u002Fnotices) | ✅ (needs Accept header) | No |\n| SF Planning calendars (sfplanning.org\u002Fhearings-*) | ✅ (use `-list` views) | No |\n| SF.gov meetings (api.sf.gov) | ✅ (Wagtail API) | No |\n| Socrata (data.sfgov.org) | ✅ | No |\n| SF Ethics (sfethics.org) | ✅ | No |\n| Mission Local \u002F journalism RSS | ✅ | No |\n| Granicus (Rec & Park) | ✅ | No |\n| Refuse Refuse SF (refuserefusesf.org) | ✅ (JS bundle) | No |\n| sfrb.org | ✅ (Wagtail API via api.sf.gov) | No |\n\n---\n\n## Scheduling\n\n### Weekly digest (Monday morning)\n```json\n{\n  \"schedule\": { \"kind\": \"cron\", \"expr\": \"0 14 * * 1\", \"tz\": \"America\u002FLos_Angeles\" },\n  \"payload\": { \"kind\": \"systemEvent\", \"text\": \"Run SF civic weekly digest and send summary\" }\n}\n```\n\n### Daily delta (weekday noon check-in)\n```json\n{\n  \"schedule\": { \"kind\": \"cron\", \"expr\": \"0 12 * * 1-5\", \"tz\": \"America\u002FLos_Angeles\" },\n  \"payload\": { \"kind\": \"systemEvent\", \"text\": \"Run SF civic daily delta and report any new agenda items\" }\n}\n```\n\n---\n\n## File Layout\n\n```\nskills\u002Fsf-civic-digest\u002F\n├── SKILL.md              ← you are here\n├── STYLE.md              ← report style guide (read before writing any report)\n├── USER.md               ← user profile: district, neighborhoods, streets, interests (fill this in)\n├── .gitignore            ← excludes runtime state from version control\n├── scripts\u002F              ← all data pipeline scripts\n│   ├── sf_weekly_digest.py      ← master aggregator\n│   ├── sf_civic_digest.py       ← Board of Supervisors (Legistar)\n│   ├── sfmta_hearings.py        ← SFMTA Engineering Hearings\n│   ├── sf_planning_notices.py   ← Planning project notices\n│   ├── sf_planning_commission.py← Planning Commission \u002F HPC \u002F ZA\n│   ├── sf_board_of_appeals.py   ← Board of Appeals\n│   ├── sf_building_permits.py   ← Building permits (Socrata)\n│   ├── sfgov_events.py          ← Supervisor events\n│   ├── sf_311.py                ← 311 service requests (Socrata)\n│   ├── sf_ethics.py             ← Lobbyist contacts + contributions\n│   ├── sf_rent_board.py         ← Rent Board\n│   ├── sf_sfmta_board.py        ← SFMTA Board of Directors\n│   ├── sf_rec_park.py           ← Rec & Park Commission\n│   ├── sf_housing_pipeline.py   ← Housing pipeline (AB2011\u002FSB35\u002Fdensity bonus)\n│   ├── sf_journalism.py         ← News aggregator (5 outlets)\n│   ├── sf_volunteer_cleanups.py ← Community cleanups (Refuse Refuse + DPW)\n│   ├── sf_evictions.py          ← Eviction notices (Socrata)\n│   ├── sf_bart_board.py         ← BART Board of Directors (Legistar)\n│   ├── sf_sfusd_board.py        ← SFUSD Board of Education\n│   ├── sf_sfcta.py              ← SF County Transportation Authority\n│   └── config_loader.py         ← District config loader\n├── reports\u002F              ← generated reports\n│   └── archive\u002F          ← older versions\n└── references\u002F\n    ├── sf-districts.md       ← district map, supervisor names, neighborhood lists\n    └── sf-build-timelines.md ← build phase benchmarks, financing signals, project context\n```\n\n---\n\n## Participation Guide\n\n### How to comment at SFMTA Engineering Hearings\n- Online: join at `sfmta.com\u002FEngHearing` when your item is called, raise hand\n- Phone: number + conference ID in hearing notice\n- Written: email the contact listed per item with \"Public Hearing\" in subject\n- Decisions posted the following Friday at `sfmta.com\u002FEngineeringResults`\n\n### How to comment at Planning Commission \u002F HPC\n- Written comments accepted before each hearing via sfplanning.org\n- HPC meets 1st and 3rd Wednesdays (low attendance, high impact)\n- In-person: City Hall Room 400\n\n### How to reach your supervisor\n- Mahmood (D5): bilal.mahmood@sfgov.org\n- Constituent meetings: request via supervisor's website\n- Board public comment: first Tuesday of each month, City Hall Room 250\n","# SF Civic Digest — SKILL.md\n\n> **Cold-start note:** This file is designed to be self-sufficient. An agent reading only SKILL.md should be able to run reports, generate digests, and understand the full data stack. No other context required.\n\n---\n\n## Quick Start\n\n```bash\n# Step 1: Find the absolute path to this skill's scripts\u002F directory\n#         (it's always a sibling of this SKILL.md file)\nSKILL_DIR=\"\u002Fabsolute\u002Fpath\u002Fto\u002Fsf-civic-digest\"\n\n# Step 2: Run scripts using that absolute path (--district N required)\npython3 \"$SKILL_DIR\u002Fscripts\u002Fsf_weekly_digest.py\" --district 5 --json\n\n# Step 3: Synthesize the JSON output into a narrative report (see STYLE.md)\n```\n\n**Note:** `sf_weekly_digest.py` makes ~22 network calls sequentially and can take 2-3 minutes. For a quick test, try a single script first: `python3 \"$SKILL_DIR\u002Fscripts\u002Fsf_journalism.py\" --district 5 --days 7 --json`\n\n**District:** Pass `--district N` (1–11) to any script. User preferences and neighborhood context live in `USER.md` — read it before writing a report. There is no `civic_config.json` or `civic_config.example.json`; those files have been removed.\n\n**⚠️ Path rule — critical for any agent (any agent, IDE, or human):**\n- All scripts must be run with the **absolute path to the scripts\u002F directory**\n- Find it: `scripts\u002F` is always a sibling of this SKILL.md file\n- Example: if SKILL.md is at `\u002Fhome\u002Falice\u002F.openclaw\u002Fworkspace\u002Fskills\u002Fsf-civic-digest\u002FSKILL.md`, then scripts are at `\u002Fhome\u002Falice\u002F.openclaw\u002Fworkspace\u002Fskills\u002Fsf-civic-digest\u002Fscripts\u002F`\n- **Never use bare relative paths like `scripts\u002Ffoo.py`** — they break when the working directory is anything other than the skill root\n- When in doubt: `realpath` on any script path gives you the absolute path\n\n---\n\n## Architecture\n\n**Scripts are data pipelines. The agent writes the narrative.**\n\nThe scripts fetch, parse, dedup, and output JSON. The agent (you) reads that JSON and synthesizes it into a report following the style guide. There is no auto-generated report — the editorial judgment is yours.\n\n```\nsf_weekly_digest.py --json\n    └── calls all subscripts → returns combined JSON\n            │\n            ▼\n    Agent reads JSON + STYLE.md\n            │\n            ▼\n    Agent writes narrative report\n```\n\nFor report generation, see **Report Generation** section below.\n\n---\n\n## All Scripts\n\n**Canonical script location:** `skills\u002Fsf-civic-digest\u002Fscripts\u002F`\n\n| Script | What it does | Method | Notes |\n|--------|-------------|--------|-------|\n| `sf_weekly_digest.py` | Master aggregator — calls all subscripts | — | Use `--json` for machine-readable output; pass to agent for synthesis |\n| `sf_civic_digest.py` | Board of Supervisors + all committees via Legistar | curl | `--daily` for delta only; `--days N`; state in `sf_civic_state.json` |\n| `sfmta_hearings.py` | SFMTA Engineering Public Hearings | curl + PDF | Street changes, parking meters, signals. Every ~2 weeks. |\n| `sf_planning_notices.py` | SF Planning project notices (Section 311) | curl | Earliest signal layer — before commission hearings. Needs `Accept: text\u002Fhtml` header. |\n| `sf_planning_commission.py` | Planning Commission, HPC, ZA full agendas | curl + PDF | Server-rendered HTML (no browser). `--body hpc` for HPC, `--body za` for ZA. |\n| `sf_board_of_appeals.py` | Board of Appeals | Wagtail API | sf.gov CMS API (`api.sf.gov`). 1st & 3rd Wednesdays, 5pm. No browser needed. |\n| `sf_building_permits.py` | Building permits citywide | Socrata REST | Every permit filed. Classified HIGH\u002FNOTABLE\u002Fnoise. State-tracked. |\n| `sfgov_events.py` | Supervisor office hours, district events | REST\u002FJSON | Very sparse — supervisor events only. Low signal. |\n| `sf_311.py` | 311 service requests by district | Socrata REST | Spike detection. Query two 7-day windows for trend comparison. |\n| `sf_ethics.py` | Lobbyist contacts + campaign contributions | RSS + Socrata | Contacts: `5f5n-tdbf`. Contributions: `e6py-fg8b`. Column names have NO underscores. |\n| `sf_rent_board.py` | Rent Board commission meetings | Wagtail API | sf.gov CMS API (`api.sf.gov`). No browser needed. Rent increase: links to sf.gov (no hardcoded value). |\n| `sf_sfmta_board.py` | SFMTA Board of Directors | curl | 1st & 3rd Tuesdays 1pm. Service changes, fare decisions, bike\u002Fped safety. |\n| `sf_rec_park.py` | Rec & Park Commission | curl (Granicus) | `view_id=91`. sfrecpark.org is unreachable from server — Granicus only. |\n| `sf_housing_pipeline.py` | AB 2011 \u002F SB 35 \u002F density bonus housing pipeline | Socrata REST | Cross-refs parcels dataset for district. Watchlist tracks 400 Divisadero. State-tracked. |\n| `sf_journalism.py` | News aggregator — 5 SF outlets | RSS | Mission Local, Streetsblog SF, SF YIMBY, 48 Hills, SF Standard. SF Examiner 404s. Archive: `sf_journalism_archive.json`. |\n| `sf_volunteer_cleanups.py` | Community cleanup events | curl\u002FJS bundle | Refuse Refuse SF + DPW Love Our City NBDs. GoDaddy SPA — data is in JS bundle, not HTML. |\n| `sf_bart_board.py` | BART Board of Directors + advisory bodies | Legistar API | `webapi.legistar.com\u002Fv1\u002Fbart\u002FEvents`. Board = HIGH, advisory = MEDIUM. `--next` for next meeting. |\n| `sf_sfusd_board.py` | SFUSD Board of Education meetings | Google Sheets + BoardDocs | 2nd & 4th Tuesdays 5pm. Falls back to projected schedule if sources unavailable. |\n| `sf_evictions.py` | Eviction notices by district | Socrata REST | Dataset `5cei-gny5`. Ellis Act + OMI = displacement signals. Trend comparison (two windows). `--district N`. |\n| `sf_sfcta.py` | SF County Transportation Authority | curl (sfcta.org) | Congestion pricing, Muni Forward, bike\u002Fped funding, Prop L sales tax. Board + CAC + committees. |\n| `sf_civic_actions.py` | Protests, rallies, civic actions | Mobilize.us API + Indybay | No auth. Rallies\u002Fmarches = HIGH, canvass\u002Fphone bank = MEDIUM. `--type rally` to filter. |\n| `sf_mission_local.py` | Mission Local news only | RSS | Subset of sf_journalism.py. Use sf_journalism.py for multi-outlet. |\n| `config_loader.py` | District config loader | — | All 11 districts pre-populated. Pass `--district N` to any script. |\n\n### No browser required\nAll scripts now work without a browser. `sf_board_of_appeals.py` and `sf_rent_board.py` use the sf.gov Wagtail CMS API (`api.sf.gov\u002Fapi\u002Fv2\u002Fpages\u002F`). `sf_planning_commission.py` uses curl against server-rendered Drupal HTML (the sfplanning.org calendar pages are not JS-dependent despite initial assumptions).\n\n---\n\n## District Configuration\n\nAll scripts accept `--district N` (1–11). That's all you need for a basic run.\n\nUser preferences and neighborhood context (streets, addresses, people to flag) live in **`USER.md`** — a human-readable profile file. There is no `civic_config.json`; that file has been removed. Read `USER.md` to understand what the user cares about before writing any report.\n\nDistrict→neighborhood mappings: `references\u002Fsf-districts.md`\nBuild timeline benchmarks: `references\u002Fsf-build-timelines.md` — **Read before writing about any housing project.** Includes typical phase durations, financing tracking methods, and context for whether a project is on track or stalled.\n\n---\n\n## Report Generation\n\n### Agent-driven (recommended for one-off reports)\n\n```bash\n# 1. Collect data (use absolute paths — see path rule above)\npython3 \u002Fabsolute\u002Fpath\u002Fto\u002Fsf-civic-digest\u002Fscripts\u002Fsf_weekly_digest.py --json > \u002Ftmp\u002Fcivic_data.json\npython3 \u002Fabsolute\u002Fpath\u002Fto\u002Fsf-civic-digest\u002Fscripts\u002Fsf_housing_pipeline.py --district 5 --json >> \u002Ftmp\u002Fcivic_data.json\npython3 \u002Fabsolute\u002Fpath\u002Fto\u002Fsf-civic-digest\u002Fscripts\u002Fsf_volunteer_cleanups.py --district 5 --days 14 --json >> \u002Ftmp\u002Fcivic_data.json\n\n# 2. Agent synthesizes following STYLE.md\n# Read STYLE.md, read the JSON, write narrative to reports\u002F\n```\n\n### Agent-driven reports (quarterly, annual, deep dives)\n\nGive your agent the workspace path and let it orchestrate:\n\n> Read STYLE.md and USER.md. Run the scripts in scripts\u002F to collect data for District 5, then write a Q1 2026 civic digest. Save to reports\u002F.\n\n**⚠️ Path gotcha:** Agents default to wrong relative paths. Always resolve the absolute path to `scripts\u002F` from the location of this SKILL.md before running anything. Use full absolute paths — e.g. `python3 \u002Ffull\u002Fpath\u002Fto\u002Fscripts\u002Fsf_housing_pipeline.py`. Never just `scripts\u002FSCRIPTNAME.py`.\n\n### Report style\nRead `STYLE.md` before writing any report. Key rules:\n- TLDR (5-7 bullets) first — last bullet is always one action\n- Officials box: YOUR elected officials only (supervisor, mayor, state reps)\n- Short sections (3-5 sentences), scan-and-skip\n- Connect threads across sources (lobbying + permits + 311 + journalism = one story)\n- End each thread with a specific action (date, email address, what to say)\n- Rates over counts. \"Up 15%\" beats \"95 reports.\"\n- Tone: pro-building, pro-tech, car-free lens. See STYLE.md for full framing guidance.\n\nReference: see `STYLE.md` for rules and examples.\n\n---\n\n## Key Data Gotchas\n\nThese will burn you if you don't know them:\n\n**Socrata column names:**\n- 311 (`vw6y-z8j6`): `supervisor_district` = `'5.0'` (float string), date field = `requested_datetime`\n- Building Permits (`i98e-djp9`): `supervisor_district` = `'5'`. Address split across `street_number`\u002F`street_name`\u002F`street_suffix` — no combined field. `estimated_cost` is a string, cast in Python.\n- Lobbyist Contacts (`5f5n-tdbf`): NO underscores — `officialname`, `clientname`, `lobbyistname`\n- Lobbyist Contributions (`e6py-fg8b`): same — `lobbyistname`, `candidatename`, `sourceoffunds`\n- Planning Records (`qvu5-m3a2`): `pim_link` returns `{\"url\": \"...\"}` dict, not string. No `supervisor_district` — cross-reference parcels (`acdm-wktn`) by `block`\u002F`lot`.\n\n**Legistar:** The API is broken for SF (returns \"Agenda Draft Status\" error). Use the RSS feed instead:\n`https:\u002F\u002Fsfgov.legistar.com\u002FFeed.ashx?M=C&ID=17442&GUID=EEE85B7C-1A1C-4A56-873E-355A0A0DE5C3&Mode=All&Format=rss`\nReturns ~100 meetings (~6 months). Parse meeting IDs from RSS, then `fetch_meeting_detail()` for agenda items.\n\n**Reddit:** Direct curl blocked (403, datacenter IP). Use `web_fetch` tool — routes differently, works.\n\n**sfrecpark.org:** Completely unreachable from this server. Granicus (`view_id=91`) is the only path.\n\n**311 trend pattern:** Query two 7-day windows (current + prior week) and show week-over-week delta. \"Encampments up 15%\" is useful. \"95 encampments\" is not.\n\n**Journalism archive:** `sf_journalism.py` persists articles to `sf_journalism_archive.json` (cap 2000). For quarterly history, use `--archive --days 90`.\n\n---\n\n## Socrata Dataset Reference\n\n| Dataset | ID | Key fields |\n|---------|-----|-----------|\n| Building Permits | `i98e-djp9` | permit_number, permit_type, address (split), supervisor_district ('5'), estimated_cost (string) |\n| 311 Cases | `vw6y-z8j6` | service_name, requested_datetime, supervisor_district ('5.0') |\n| Planning Dept Records | `qvu5-m3a2` | record_id, description, record_status, project_address, block, lot, number_of_units_net, pim_link (dict) |\n| SF Parcels | `acdm-wktn` | block_num, lot_num, supervisor_district, zoning_code |\n| Lobbyist Contacts | `5f5n-tdbf` | officialname, lobbyistname, clientname, outcomesought, subjectarea, filenumber |\n| Lobbyist Contributions | `e6py-fg8b` | lobbyistname, candidatename, sourceoffunds, committeename |\n| Assessor Parcels | `fk72-cxc3` | property_location, parcel_number, assessed_land_value, zoning_code |\n| Eviction Notices | `5cei-gny5` | eviction_id, address, neighborhood, file_date, supervisor_district, ellis_act_withdrawal, owner_move_in |\n\nQuery pattern: `https:\u002F\u002Fdata.sfgov.org\u002Fresource\u002F{id}.json?$where=supervisor_district='5'&$order=date+DESC&$limit=50`\n\n---\n\n## Scraping Method Reference\n\n| Site | curl works? | Browser needed? |\n|------|-------------|-----------------|\n| Legistar (sfgov.legistar.com) | ✅ | No |\n| SFMTA (sfmta.com) | ✅ | No |\n| SF Planning notices (sfplanning.org\u002Fnotices) | ✅ (needs Accept header) | No |\n| SF Planning calendars (sfplanning.org\u002Fhearings-*) | ✅ (use `-list` views) | No |\n| SF.gov meetings (api.sf.gov) | ✅ (Wagtail API) | No |\n| Socrata (data.sfgov.org) | ✅ | No |\n| SF Ethics (sfethics.org) | ✅ | No |\n| Mission Local \u002F journalism RSS | ✅ | No |\n| Granicus (Rec & Park) | ✅ | No |\n| Refuse Refuse SF (refuserefusesf.org) | ✅ (JS bundle) | No |\n| sfrb.org | ✅ (Wagtail API via api.sf.gov) | No |\n\n---\n\n## Scheduling\n\n### Weekly digest (Monday morning)\n```json\n{\n  \"schedule\": { \"kind\": \"cron\", \"expr\": \"0 14 * * 1\", \"tz\": \"America\u002FLos_Angeles\" },\n  \"payload\": { \"kind\": \"systemEvent\", \"text\": \"Run SF civic weekly digest and send summary\" }\n}\n```\n\n### Daily delta (weekday noon check-in)\n```json\n{\n  \"schedule\": { \"kind\": \"cron\", \"expr\": \"0 12 * * 1-5\", \"tz\": \"America\u002FLos_Angeles\" },\n  \"payload\": { \"kind\": \"systemEvent\", \"text\": \"Run SF civic daily delta and report any new agenda items\" }\n}\n```\n\n---\n\n## File Layout\n\n```\nskills\u002Fsf-civic-digest\u002F\n├── SKILL.md              ← you are here\n├── STYLE.md              ← report style guide (read before writing any report)\n├── USER.md               ← user profile: district, neighborhoods, streets, interests (fill this in)\n├── .gitignore            ← excludes runtime state from version control\n├── scripts\u002F              ← all data pipeline scripts\n│   ├── sf_weekly_digest.py      ← master aggregator\n│   ├── sf_civic_digest.py       ← Board of Supervisors (Legistar)\n│   ├── sfmta_hearings.py        ← SFMTA Engineering Hearings\n│   ├── sf_planning_notices.py   ← Planning project notices\n│   ├── sf_planning_commission.py← Planning Commission \u002F HPC \u002F ZA\n│   ├── sf_board_of_appeals.py   ← Board of Appeals\n│   ├── sf_building_permits.py   ← Building permits (Socrata)\n│   ├── sfgov_events.py          ← Supervisor events\n│   ├── sf_311.py                ← 311 service requests (Socrata)\n│   ├── sf_ethics.py             ← Lobbyist contacts + contributions\n│   ├── sf_rent_board.py         ← Rent Board\n│   ├── sf_sfmta_board.py        ← SFMTA Board of Directors\n│   ├── sf_rec_park.py           ← Rec & Park Commission\n│   ├── sf_housing_pipeline.py   ← Housing pipeline (AB2011\u002FSB35\u002Fdensity bonus)\n│   ├── sf_journalism.py         ← News aggregator (5 outlets)\n│   ├── sf_volunteer_cleanups.py ← Community cleanups (Refuse Refuse + DPW)\n│   ├── sf_evictions.py          ← Eviction notices (Socrata)\n│   ├── sf_bart_board.py         ← BART Board of Directors (Legistar)\n│   ├── sf_sfusd_board.py        ← SFUSD Board of Education\n│   ├── sf_sfcta.py              ← SF County Transportation Authority\n│   └── config_loader.py         ← District config loader\n├── reports\u002F              ← generated reports\n│   └── archive\u002F          ← older versions\n└── references\u002F\n    ├── sf-districts.md       ← district map, supervisor names, neighborhood lists\n    └── sf-build-timelines.md ← build phase benchmarks, financing signals, project context\n```\n\n---\n\n## Participation Guide\n\n### How to comment at SFMTA Engineering Hearings\n- Online: join at `sfmta.com\u002FEngHearing` when your item is called, raise hand\n- Phone: number + conference ID in hearing notice\n- Written: email the contact listed per item with \"Public Hearing\" in subject\n- Decisions posted the following Friday at `sfmta.com\u002FEngineeringResults`\n\n### How to comment at Planning Commission \u002F HPC\n- Written comments accepted before each hearing via sfplanning.org\n- HPC meets 1st and 3rd Wednesdays (low attendance, high impact)\n- In-person: City Hall Room 400\n\n### How to reach your supervisor\n- Mahmood (D5): bilal.mahmood@sfgov.org\n- Constituent meetings: request via supervisor's website\n- Board public comment: first Tuesday of each month, City Hall Room 250\n",{"name":5,"description":7},"master","4aa004da461d820f4ea5499e58eb8d196cf99016","community\u002Fclawhub\u002Fs\u002Fsf-civic-digest",0,"https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge","https:\u002F\u002Fskill-explorer-rho.vercel.app","https:\u002F\u002Fgithub.com\u002FLord1Egypt","Unbreakable. Unstoppable. Unmatched⚡.\r\n Speaker of machine tongues 🤖  | World-builder of decentralized dreams 🌐 | Defender of the digital realm🛡️.","2026-06-10 08:21:01",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add Lord1Egypt\u002Fawesome-skill-forge --skill sf-civic-digest",{"tool":39,"command":40},"bunx","bunx skills add Lord1Egypt\u002Fawesome-skill-forge --skill sf-civic-digest",{"tool":42,"command":43},"pnpm","pnpm dlx skills add Lord1Egypt\u002Fawesome-skill-forge --skill sf-civic-digest","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fs\u002Fsf-civic-digest\u002FSKILL.md",true,[],[48,55,62,69,76,83],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":19},"01M785WKJB99G3STR1NF9NRTJW","youtube-content","YouTube transcripts to summaries, threads, blogs.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fyoutube-content\u002FSKILL.md",[],[],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":19},"01M785WEFHB0G2S9YA6EPR3H0E","xurl","X\u002FTwitter via xurl CLI: post, search, DM, media, v2 API.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fxurl\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M785W98EDN4EFJXJPMQEHCRC","touchdesigner-mcp","Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftouchdesigner-mcp\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M785W5S9FP3QBH2V191E025P","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M785W2AS08NSSH9YATCV6FJB","teams-meeting-pipeline","Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fteams-meeting-pipeline\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M785VXKW4T34BTP1SCHW1R7F","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",[],[]]