build-faq-from-issues

Extract common questions from closed GitHub issues and generate an FAQ document with answers

Stars 2

Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/britt/claude-code-skills/tree/main/skills/build-faq-from-issues

SKILL.md

Build FAQ from Issues Skill

Extract common questions from closed GitHub issues and generate a structured FAQ document with answers and source links.

When to Use

Activate when:

Creating or updating project FAQ
Documenting common support questions
Reducing repeat questions in issues
Onboarding new users/contributors

Output Structure

markdown

## FAQ: [Project/Topic]

**Generated from**: [X closed issues] | **Labels**: [question, help, support]

### General

#### Q: [Common question]

[Answer synthesized from issue resolution]

— See #123

#### Q: [Another question]

[Answer]

— See #456

### Setup & Installation

#### Q: [Setup question]

[Answer with steps if needed]

— See #789

### Troubleshooting

#### Q: [Error or problem question]

[Answer with solution]

— See #101

### Configuration

#### Q: [Config question]

[Answer]

— See #202

Guidelines

Question Selection

Focus on closed/resolved issues
Prioritize issues labeled: question, help, support, faq
Include frequently recurring questions
Skip one-off bugs or feature requests

Answer Quality

Write standalone answers (don't require reading the issue)
Include concrete steps when applicable
Keep answers concise but complete
Link to docs if more detail exists elsewhere

Organization

Group by logical categories
Put most common questions first within each category
Use consistent question phrasing ("How do I..." vs "Why does...")
Deduplicate similar questions into single entry

Deduplication

When multiple issues ask the same thing:

Combine into one FAQ entry
Reference all related issues: "See #123, #456"
Use the clearest answer from any of them

Maintenance Notes

Note when FAQ was last generated
Flag answers that may be outdated
Suggest issues that should be added to FAQ