Agent skill
gh-task-shaper
Shape work into GitHub issues. Use this skill when Codex needs to turn a vague idea into a clear pitch, decide whether to open a new issue, and set up branches with gh.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/gh-task-shaper
SKILL.md
GitHub Task Shaper
Follow the shaper workflow in docs/shaper-guide.md. Use this skill only for shaping and triage; do not write, review, or test code.
Workflow (Summary)
- Gather context from the current issue or user request.
- If the issue has commits or the bet marker (
<!-- issue is shaped -->), do not reshape; create a new issue for changes. - If the issue has no commits and no bet marker, update the issue description to reflect the shaper guide.
- When the shaper confirms the issue is shaped, add an invisible HTML comment in the issue description to mark the bet.
- Create a GitHub branch for each new issue using the script below.
Bet Marker
Use this invisible HTML comment in the issue description to track shaped/bet status:
<!-- issue is shaped -->
Using Existing Skills
gh-current-issueto get the issue number from the branch.gh-issue-commenterto add shaping updates as comments.gh-issue-plannerto sync plan sections if the issue already has a plan marker.
Branch Creation
Create a remote branch after creating a new issue:
.codex/skills/gh-task-shaper/scripts/create_issue_branch.sh <issue-number>
The script returns the created (or existing) branch name.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?