fix: skill issue

Name: skill-issue
Author: paultyng

Personal user-level agent skills, rules, and settings. Available across all projects.

Install

Clone or symlink this repo to the user-level config directory:

Editor	Path
Claude Code	`~/.claude/`
Cursor	`~/.cursor/`

Skills

Skill	Description
analyze-sessions	Analyze past agent sessions to identify friction and recommend new skills and rules.
ci-debug-loop	Watch a CI run, diagnose failures, apply fixes, and re-trigger until green or escalate.
create-decision-document	Create or update a Notion decision doc with a terse options/pros/cons/recommendation template.
create-jira-item	Create Jira issues (stories, epics, initiatives) with custom field introspection.
create-rule	Create or update Claude Code rule files with proper format and path scoping.
create-skill	Create well-structured Cursor agent skills following best practices.
fix-pr-conflict	Resolve merge conflicts on a pull request by rebasing onto the base branch.
push-and-watch	Push local commits to the remote, ensure a draft PR exists, and monitor the GitHub Actions run until completion.
rebase-pr-chain	Rebase a chain of dependent PRs sequentially, fixing conflicts along the way.
review-all	Comprehensive review orchestrator — launches review-security, review-reliability, review-code, review-database, and review-documentation as parallel subagents and consolidates results.
review-code	Review code architecture (SOLID, design patterns, package design), Go best practices, and protobuf/API design using manual analysis and static analysis tools.
review-database	Review database usage for migration safety, query performance, connection/transaction management, and schema design (PostgreSQL and MySQL).
review-documentation	Review documentation quality and sync with implementation across Go doc comments, proto comments, OpenAPI specs, markdown files, and example tests.
review-reliability	Review reliability covering graceful shutdown, gRPC production patterns, and stability patterns/anti-patterns.
review-security	Security review using STRIDE threat modeling, OWASP Top 10 analysis, and automated scanning (gosec, govulncheck).
ship-it	End-to-end shipping workflow: fmt, lint, test, changelog, commit (conventional commits), push, update PR, and suggest reviewers.
verify-when-complete	Run format, lint, build, and test verification before claiming work is complete. Detects project toolchain automatically.

Rules

Rules load automatically every session (or on file-path match) and shape agent behavior.

Rule	Description
draft-prs	Always create draft PRs unless explicitly told otherwise.
escalation	Stop and ask a human before making ambiguous or architectural decisions.
git-no-amend	No `--amend` unless asked. Conventional Commits format.
go-defaults	Universal Go conventions: context, error wrapping, testing.
minimal-changes	Only make the changes that were requested.
parallelize-subagents	Launch independent subagents in parallel, not sequentially.
research-tools	Pick the right tool: Sourcegraph, web search, or Notion.
taskfile-not-make	Use go-task (`Taskfile.yaml`), not Makefiles.
terse-output	Concise, direct output. No filler.
testing-philosophy	Real code over mocks. Tests may use a real database.

Suggested MCP Servers

Some skills expect these MCP servers to be available. All are optional -- skills degrade gracefully without them.

MCP Server	Used by	Docs
Atlassian	create-jira-item	Getting started
Notion	create-decision-document	Setup
Sourcegraph	review-*, create-decision-document	Setup

Inspired and influenced by Superpowers.

License

MIT