jacobpevans/shape-issues
github-workflows/skills/shape-issues/SKILL.md
Shape raw ideas into actionable GitHub Issues using Shape Up methodology
$ install --global
skillsauthnpx skillsauth add jacobpevans/claude-code-plugins shape-issuesInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 22, 2026, 7:51 PM61.7s1 file scanned
SKILL.md
- name:
- shape-issues
- description:
- Shape raw ideas into actionable GitHub Issues using Shape Up methodology
Shape Issues
Iterative issue exploration and shaping process that transforms rough ideas into well-defined, time-boxed GitHub Issues using Shape Up methodology and continuous discovery principles.
Attribution: Based on work by roksechs
Phases
- Problem Exploration: Examine raw ideas, map pain points, assess timebox
- Solution Sketching: Brainstorm approaches, set scope boundaries, identify risks
- Issue Formation: Problem statement, timebox, solution sketch, rabbit holes
- Betting Table: Prioritize by timebox, balance portfolio, set circuit breakers
- Issue Crafting: Create GitHub Issues with size labels, add
ready-for-devlabel for developer pickup
Sizing
| Label | Duration |
| --- | --- |
| size:xs | < 1 day |
| size:s | 1-3 days |
| size:m | 3-5 days |
| size:l | 1-2 weeks |
| size:xl | 2+ weeks |
Workflow
- Gather context:
gh issue list,gh pr list - Explore problem: user complaints, workflow friction, timebox check
- Sketch solutions: 2-3 approaches, scope boundaries, rabbit holes
- Set timebox: spike vs small batch vs big batch
- Create issue:
gh issue createwith template, addready-for-devlabel
Issue Template
Key sections: Problem (raw idea, pain, size), Solution Sketch (concept, out of scope), Rabbit Holes (complexity traps), Done Looks Like (acceptance criteria).
Usage
/shape-issues
Workflow: /shape-issues -> implementation -> /ship
Related Skills
- pr-standards (git-standards) — PR authoring and review standards applied after issues are implemented
Related Skills
jacobpevans/self-hosted-runners
documentation
VerifiedTrustedCommunity
Use when editing GitHub Actions workflow files (.github/workflows/*.yml) in JacobPEvans repos. Documents when to target self-hosted RunsOn runners vs GitHub-hosted runners, the v3 label catalog used across the org, the required github.run_id segment, and the GitHub App allowlist prereq.
2SKILL.mdUpdated May 16, 2026
jacobpevans/refresh-repo
testing
VerifiedTrustedCommunity
Check PR merge readiness, sync local repo, cleanup stale worktrees; optional cross-repo sweep and stale-branch prune modes
2SKILL.mdUpdated Apr 28, 2026
jacobpevans/rebase-pr
tools
VerifiedTrustedCommunity
Local rebase-merge workflow for pull requests with signed commits
2SKILL.mdUpdated Apr 28, 2026
jacobpevans/gh-cli-patterns
tools
VerifiedTrustedCommunity
Canonical reference for all gh CLI command shapes used by skills in this plugin. Defines the placeholder convention, allowed --json fields, GraphQL fallback rules, -f/-F/--raw-field flag semantics, the PR-readiness gate, code-scanning alert query, review-thread fetch/count/resolve mutations, and heredoc bodies. Prevents Unknown JSON field errors and divergent query shapes.
2SKILL.mdUpdated Apr 28, 2026