# Add Reporter

> Add Reporter is an Agent Skill for development published in the oxsecurity/megalinter repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Add a new output reporter to MegaLinter. Use when adding support for a new CI system or output format.

- Skill name: `add-reporter`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/oxsecurity/megalinter/blob/HEAD/.claude/skills/add-reporter/SKILL.md
- Repository: oxsecurity/megalinter (2,533 GitHub stars when collected)

## SKILL.md

Guide through adding a new reporter named `$ARGUMENTS` to MegaLinter.

Steps:

1. **Create the class** in `megalinter/reporters/<Name>Reporter.py` extending `megalinter.Reporter`
2. **Implement required methods**:
   - `manage_activation()` — check env var like `<NAME>_REPORTER=true` to enable/disable
   - `produce_report()` — generate the report output
   - Optionally: `initialize()`, `add_report_item()`
3. **Register the reporter** — check how existing reporters are discovered and loaded in `megalinter/MegaLinter.py`
4. **Reference patterns** from existing reporters:
   - Simple output: `ConsoleReporter.py`, `TapReporter.py`
   - CI integration: `GithubCommentReporter.py`, `GitlabCommentReporter.py`
   - File output: `JsonReporter.py`, `SarifReporter.py`
   - External service: `ApiReporter.py`, `EmailReporter.py`
5. **Update documentation** — add a docs page describing configuration
6. **Update `CHANGELOG.md`** in the repository root (not docs/) — add one line under **Reporters** in the beta section:
   ```text
   - Add <ReporterName>: <what CI system or output format it supports, one sentence>
   ```
7. **Branch naming**: use `user/add-<reporter-name>-reporter`

---

Source: https://www.openparable.com/skill/development/add-reporter (OpenParable). Cite the canonical URL above.
