Vellum PR Readiness
Testing & Qualityvellum-pr-readinessVellum PR Readiness is an Agent Skill for testing & quality published in the vellum-ai/vellum-assistant repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Prepare Vellum Assistant branches for review by checking git hygiene, PR scope, tests, docs, migrations, Linear linking, and companion repo needs. Use before creating a pull request, splitting work into PRs, or asking whether a branch is ready.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/vellum-ai/vellum-assistant/blob/HEAD/.cursor/skills/vellum-pr-readiness/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/vellum-pr-readiness, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Vellum PR Readiness
Goal
Confirm the branch is reviewable, scoped, and verified before opening a PR. Prefer surfacing blockers over polishing summaries.
Checklist
- Inspect
git statusand identify unrelated changes, generated artifacts, deleted files, and untracked files. - Inspect staged and unstaged diffs before recommending a commit or PR.
- Check for secrets:
- Do not commit
.env, credentials, tokens, private keys, or local workspace data. .env.exampleis allowed only for placeholder values.
- Do not commit
- Check scope:
- If the branch is too large, suggest splitting it into smaller, reviewable PR branches.
- Separate unrelated UI, backend, migration, and infra changes when practical.
- Check required follow-ups:
- Migration needed for persisted data or workspace format changes.
- Docs needed for significant architecture, service, or data-flow changes.
- Companion
vellum-assistant-platformPR needed for platform-affecting contracts or new feature flags.
- Check Linear conventions:
- Branch, commit body, and PR body should include the Linear issue ID when one exists.
- Use
Closes JARVIS-123for single final PRs. - Use
Part of JARVIS-123for intermediate PRs in multi-PR plans.
- Check verification:
- Focused tests ran for changed behavior.
- Typecheck ran when exported contracts or cross-package types changed.
- Any skipped tests are explicitly called out.
PR Body Template
Use this compact structure unless the user asks for another format:
## Summary
- ...
## Test Plan
- ...
## Risk
- ...
Mention migrations, feature flags, rollout state, and companion PRs when relevant.
Human Attention Comments
For non-routine changes, leave a PR comment calling out review focus and risk level. Skip this for routine low-risk changes.