Skip to content

chore: add PR title validation skill and task#8239

Draft
scarf005 wants to merge 3 commits intocataclysmbn:mainfrom
scarf005:chore/pr-title-skill
Draft

chore: add PR title validation skill and task#8239
scarf005 wants to merge 3 commits intocataclysmbn:mainfrom
scarf005:chore/pr-title-skill

Conversation

@scarf005
Copy link
Member

@scarf005 scarf005 commented Feb 24, 2026

Purpose of change (The Why)

Improve PR title quality and changelog consistency by adding a reusable skill that picks proper Conventional Commit type/scope and enforces docs-heavy PRs to use docs type.

Describe the solution (The How)

  • add .agents/skills/pr-title/SKILL.md with explicit PR type/scope selection rules
  • add skill-local script .agents/skills/pr-title/scripts/pr_title.ts to validate <type>(<scope>): <subject> and enforce docs-majority rule (>80% in docs/ => docs type)
  • follow Agent Skills scripts/ structure instead of adding a project-level deno task for skill-only behavior
  • auto-run deno task semantic when newly added mods are detected

Describe alternatives you've considered

  • relying only on reviewer judgment (rejected: inconsistent and error-prone)
  • adding a static lint-only rule without file-aware checks (rejected: cannot enforce docs-majority policy)

Testing

  • deno fmt .agents/skills/pr-title/SKILL.md .agents/skills/pr-title/scripts/pr_title.ts deno.jsonc
  • deno check .agents/skills/pr-title/scripts/pr_title.ts
  • deno lint .agents/skills/pr-title/scripts/pr_title.ts .agents/skills/pr-title/SKILL.md
  • deno run -R -N --allow-run=git,deno .agents/skills/pr-title/scripts/pr_title.ts --title \"docs: add pr-title skill guidance\"

Additional context

None.

Checklist

Mandatory

@github-actions github-actions bot added the scripts related to game management scripts label Feb 24, 2026
@scarf005 scarf005 force-pushed the chore/pr-title-skill branch from e7ca92b to 5555844 Compare February 24, 2026 18:16
@github-actions github-actions bot removed the scripts related to game management scripts label Feb 24, 2026
scarf005 and others added 3 commits February 25, 2026 03:48
Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>
Assisted-by: openai/gpt-5.3-codex on opencode
Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>
Assisted-by: openai/gpt-5.3-codex on opencode
Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>
Assisted-by: openai/gpt-5.3-codex on opencode
@scarf005 scarf005 force-pushed the chore/pr-title-skill branch from a437a74 to 4170596 Compare February 24, 2026 18:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant