---
name: github-issues
description: Create, evaluate, and triage GitHub issues for CausalPy. Use when filing a bug, proposing an enhancement, analyzing existing issues, or splitting large work into parent-child sub-issues.
---

# GitHub Issues

This skill covers issue creation, bug reporting, and issue evaluation workflows.

## When to use

- Filing a new issue (bug, enhancement, or task)
- Evaluating an existing issue and proposing next steps
- Preparing issue content for user review before posting
- Breaking large work into one parent issue with sub-issues

## References

- [Issue creation workflow](reference/issue-creation.md)
- [Bug report workflow](reference/bug-report.md)
- [Issue evaluation workflow](reference/issue-evaluation.md)
- [Parent-child sub-issues workflow](reference/parent-child-issues.md)

## Important behavior

- If native sub-issues are not available, do not silently switch to fallback.
- Explain the limitation and ask the user whether to proceed with markdown tracking links.