# Archestra Pr Hygiene

> Use when opening or updating an Archestra pull request to write an accurate conventional title and a practical, evidence-based description.

- Skill: `archestra-ai/archestra-pr-hygiene` (Agent Skill)
- Install (CLI): `npx skillmds@latest add archestra-ai/archestra-pr-hygiene`
- Raw SKILL.md: https://api.skillmd.com/api/skills/archestra-ai/archestra-pr-hygiene/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: archestra-ai (https://skillmd.com/u/archestra-ai)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/archestra-ai/archestra-pr-hygiene

---


# Archestra pull request hygiene

Review the final diff and commit history before writing PR metadata. Describe the change that is actually present, not the work session that produced it.

## Title

Follow `.github/commitlint.config.js`: use a conventional-commit title such as `feat(scope): add runtime credentials`, choose one of its allowed types, omit a trailing period, and stay within its 100-character limit. Keep the title focused on the PR's primary outcome.

## Description

Keep the body concise and concrete. Cover:

- the problem or user need being addressed;
- the implementation approach and important behavior changes;
- meaningful alternatives or tradeoffs, when they affected the design;
- how the change was exercised as a real workflow, including the scenario and observed result.

Do not pad the description with a list of routine commands, lint/type-check status, test counts, generic claims of quality, or a file-by-file changelog. Mention an automated check only when it validates a behavior that is otherwise difficult to explain or when its result is material to the reviewer.

Before opening or updating the PR, verify that the title and body still match the final diff and do not expose secrets, private data, or customer identifiers.