faq-builder
Convert a project, policy, or controversy into a plain-language public FAQ that reduces repeated confusion.
- License 许可
- MIT
- 最近更新
- 2026-11-02
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- faq-builder
- description
- Convert a project, policy, or controversy into a plain-language public FAQ that reduces repeated confusion.
- argument-hint
- [ "topic" ]
03 SKILL.md 正文
FAQ Builder
Purpose: Turn complex municipal decisions into a short, accurate FAQ that answers the questions residents actually ask, in the order they ask them.
Required inputs
- Topic, current status, and decision timeline
- Source documents: staff report, ordinance or resolution, maps, budget
- Question sources: 311 logs, emails, public comments, social posts, council questions
- Facts that are settled vs. still under consideration
Workflow
- Collect real questions from the sources above; cluster them by theme (what, why, who, how much, when, where, how to participate, what happens next). Use residents' wording, then translate jargon.
- Rank by frequency and consequence. Open with "What is this?" and "How does it affect me?" Put "How can I weigh in?" high with dates and methods.
- Write each answer in 2-4 short sentences at about an 8th-grade reading level. State the fact, the source, and the date. Define terms once.
- Handle contested topics neutrally: describe the options, the reasons for each, and the decision process; do not advocate on a pending decision (public funds generally cannot be used to campaign for a ballot measure; verify state law). Distinguish "adopted," "proposed," and "under study."
- Address misconceptions respectfully ("Some residents have asked whether...") with evidence.
- Include numbers carefully: show units, timeframe, funding source, and what is not included. Verify each number against the staff report.
- Include process facts: meeting dates, comment deadlines, contacts, how decisions are made, appeals.
- Accessibility and language: plain headings, alt text for graphics, translation plan (see
language-access-plan). - Maintain it: version date, owner, review trigger; keep a changelog and archive old versions as records.
Output structure
- Title and "last updated" line
- 8-15 questions in groups, each with short answer and source
- "What we do not know yet" box
- How to participate and contact information
- Internal sheet: source citations, approver, and open items
Example
Will my taxes go up? The proposal does not change the property-tax rate. It would use $__ from the __ fund (source: staff report, p. 4). Any future rate change would require a separate public hearing.
Red flags / escalate to the city attorney
- Statements about legal rights, liability, or the effect of litigation
- Pending litigation, bids, or personnel matters
- Anything that sounds like promoting a candidate or ballot measure
Common mistakes
- Answering the questions staff wish residents asked
- Mixing plan, proposal, and adopted policy
- Letting the FAQ go stale after a vote
Not legal advice.
04 同仓库更多 Skills
town-hall-kit
Prepare a town hall kit with agenda, ground rules, likely questions, follow-up method, and message priorities.
speechwriter
Draft remarks for the mayor, council, manager, or department head in a strong but grounded municipal voice.
social-post-series
Generate a multi-post city social media series with tone control, accessibility, and channel fit.
public-comment-summarizer
Synthesize hearing or meeting comments into themes, misconceptions, unanswered questions, and response options.
press-release-writer
Write a city press release that is accurate, readable, and aligned with legal and operational review needs.
meeting-notice-drafter
Draft a legally sufficient public notice for any city council, board, commission, or committee meeting — covering required content, posting deadlines, and special-meeting or emergency-meeting rules.