{"id":48684049,"url":"https://github.com/klauern/skills","last_synced_at":"2026-04-11T03:47:43.960Z","repository":{"id":320263322,"uuid":"1079857189","full_name":"klauern/skills","owner":"klauern","description":"Claude Code Skills","archived":false,"fork":false,"pushed_at":"2026-04-02T18:53:03.000Z","size":800,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-11T03:47:41.631Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/klauern.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-10-20T13:47:37.000Z","updated_at":"2026-04-02T18:53:05.000Z","dependencies_parsed_at":"2025-10-22T21:36:52.751Z","dependency_job_id":null,"html_url":"https://github.com/klauern/skills","commit_stats":null,"previous_names":["klauern/skills"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/klauern/skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klauern%2Fskills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klauern%2Fskills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klauern%2Fskills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klauern%2Fskills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/klauern","download_url":"https://codeload.github.com/klauern/skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klauern%2Fskills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31668050,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-10T17:19:37.612Z","status":"online","status_checked_at":"2026-04-11T02:00:05.776Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-11T03:47:43.323Z","updated_at":"2026-04-11T03:47:43.949Z","avatar_url":"https://github.com/klauern.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# klauern-skills\n\nCustom skills and commands for Claude Code.\n\n## Overview\n\nThis is a Claude Code plugin marketplace repository containing three plugins that automate Git workflows, pull request management, and development utilities. The repository is organized similarly to the official [Anthropic skills repository](https://github.com/anthropics/skills).\n\n**Plugins**:\n- **commits** - Conventional commit message creation following conventionalcommits.org\n- **pull-requests** - Intelligent PR creation, updates, conflict resolution, and comment review\n- **dev-utilities** - Development workflow utilities (AGENTS.md generation, GH Actions upgrades, CI analysis, git optimization, worktrees)\n\n## Installation\n\n### Interactive Installation\n\n```bash\n/plugin\n```\n\nSelect \"Browse Plugins\" and install the desired plugins from the `klauern-skills` marketplace.\n\n### Add Marketplace\n\nAdd the marketplace once (GitHub repo or local path):\n\n```bash\n# From GitHub repository\n/plugin marketplace add klauern/klauern-skills\n\n# Or from local path\n/plugin marketplace add /path/to/klauern-skills\n```\n\n### Install Plugins\n\nInstall one or more plugins from the marketplace:\n\n```bash\n# Install all three plugins\n/plugin install commits@klauern-skills\n/plugin install pull-requests@klauern-skills\n/plugin install dev-utilities@klauern-skills\n\n# Or install selectively\n/plugin install commits@klauern-skills\n```\n\n### Verify Installation\n\n```bash\n/help\n```\n\nYou should see the commands from installed plugins listed.\n\n### Local Development\n\n1. Clone this repository:\n\n```bash\ngit clone https://github.com/klauern/klauern-skills.git\n```\n\n2. Add the local marketplace and install plugins:\n\n```bash\n/plugin marketplace add /Users/nklauer/dev/klauern-skills\n/plugin install commits@klauern-skills\n/plugin install pull-requests@klauern-skills\n/plugin install dev-utilities@klauern-skills\n```\n\n## Available Skills\n\n### commits Plugin\n\n#### conventional-commits\n\nA skill that helps write conventional commit messages following best practices and the Conventional Commits specification.\n\n**Usage**: Claude will automatically use this skill when you ask for help with commit messages.\n\n### pull-requests Plugin\n\n#### pr-creator\n\nAn intelligent pull request creation skill that discovers and parses PR templates, analyzes commits to infer context, and prompts only for information that can't be automatically determined.\n\n**Features**:\n\n- Auto-discovers PR templates from common locations\n- Analyzes commit history to extract PR title, type, related issues, and breaking changes\n- Intelligently fills template fields based on file changes\n- Pre-checks template checkboxes (e.g., \"Tests added\" if test files were modified)\n- Minimizes manual input by only prompting for information that can't be inferred\n- Creates PRs using GitHub CLI with proper formatting\n\n**Usage**: Claude will automatically use this skill when you ask to create a pull request, or use the `/pull-requests:pr` command.\n\n#### pr-conflict-resolver\n\nIntelligently resolves merge conflicts by analyzing both branches, detecting conflict patterns, and suggesting resolution strategies.\n\n**Features**:\n\n- Categorizes conflicts by complexity\n- Analyzes intent of changes on both sides\n- Auto-resolves simple conflicts (whitespace, imports, formatting) when safe\n- Provides context-aware guidance for complex manual resolution\n- Maintains code quality during conflict resolution\n\n**Usage**: Claude will use this skill when resolving merge conflicts, or use the `/pull-requests:merge-conflicts` command.\n\n### dev-utilities Plugin\n\n#### claude-md-generator\n\nA skill that generates high-quality AGENTS.md files following the agents.md specification and HumanLayer's best practices. Supports both single-file and multi-file patterns.\n\n**Features**:\n\n- **Two patterns**: Single AGENTS.md (30-60 lines) OR .cursor/rules/ (4-8 files, 10-30 lines each)\n- Interactive wizard to choose and configure pattern\n- Generates files with WHAT/WHY/HOW structure\n- Always creates CLAUDE.md → AGENTS.md symlink for Claude Code compatibility\n- Follows agents.md spec (universal format for all AI coding assistants)\n- Suggests progressive disclosure patterns for complex topics\n- Follows instruction budget best practices (~150-200 total)\n- Avoids anti-patterns (style guides, code snippets, task-specific content)\n- Domain-specific files for multi-tech stacks (react.md, typescript.md, testing.md, etc.)\n\n**Usage**: Use `/dev-utilities:generate-rules` to launch the interactive wizard.\n\n#### gh-actions-upgrader\n\nAutomatically detects, analyzes, and upgrades GitHub Actions in workflows. Identifies forked actions and recommends upstream equivalents, handles major version upgrades with breaking change detection.\n\n**Features**:\n\n- Scans all workflow files to identify action versions\n- Uses GitHub API to detect forked actions and recommend upstream alternatives\n- Identifies breaking changes in major version upgrades\n- Plans upgrade strategies with parameter updates\n- Creates comprehensive upgrade PRs with migration notes\n\n**Usage**: Use the `/dev-utilities:gh-actions-upgrade` command.\n\n#### ci-failure-analyzer\n\nAutonomously analyzes GitHub Actions CI failures, parses logs, identifies root causes, and applies fixes for common issues.\n\n**Features**:\n\n- Detects failing checks on PRs and branches\n- Parses failure logs to identify root causes\n- Categorizes issues into fixable vs. non-fixable\n- Applies automated fixes for formatting, linting, test failures, and dependency problems\n- Provides comprehensive analysis with actionable recommendations\n\n**Usage**: Use the `/dev-utilities:gh-checks` command when CI checks fail.\n\n#### git-optimize\n\nComprehensive Git repository optimization including branch cleanup, garbage collection, and repository maintenance.\n\n**Features**:\n\n- Smart merge-aware branch detection and cleanup (git-trim integration)\n- Remote maintenance and pruning\n- Repository optimization through garbage collection and repacking\n- Combined workflows for one-command full optimization\n\n**Usage**: Use the `/dev-utilities:git-optimize` command.\n\n## Available Commands\n\nCommands are organized by plugin. Each command is invoked with the format `/plugin-name:command-name`.\n\n### commits Plugin\n\n#### /commits:commit\n\nCreate a well-formatted commit using the Conventional Commits specification.\n\n**Usage**:\n\n```bash\n/commits:commit\n```\n\nThis command will:\n\n- Analyze your staged and unstaged changes\n- Review recent commit history for style consistency\n- Create a properly formatted conventional commit message\n- Commit the changes (does not push to remote)\n\n#### /commits:commit-push\n\nCreate a well-formatted commit and push it to the remote repository.\n\n**Usage**:\n\n```bash\n/commits:commit-push\n```\n\nThis command will:\n\n- Analyze your staged and unstaged changes\n- Review recent commit history for style consistency\n- Create a properly formatted conventional commit message\n- Commit the changes\n- Push to the remote repository\n\n### pull-requests Plugin\n\n#### /pull-requests:pr\n\nCreate an intelligent pull request with automatic template filling.\n\n**Usage**:\n\n```bash\n/pull-requests:pr\n```\n\nThis command will:\n\n- Discover and parse your repository's PR template\n- Analyze commit history to infer PR title, type, and related issues\n- Detect breaking changes from commit messages\n- Pre-fill template checkboxes based on file changes (tests, docs, etc.)\n- Only prompt for information that can't be automatically determined\n- Create the PR using GitHub CLI (`gh`)\n- Return the PR URL\n\n**Requirements**:\n\n- GitHub CLI (`gh`) must be installed and authenticated\n- Current branch must have commits not in the base branch\n\n**Example**:\n\n```bash\n/pull-requests:pr\n\n# Output:\n# I found your PR template and analyzed your branch:\n# ✓ Title: feat: Add user authentication\n# ✓ Type: New feature\n# ✓ Related Issue: Closes #42\n# ✓ Tests: Added\n#\n# Your template requires:\n# 1. Why are we making this change?\n# \u003e [You provide context]\n#\n# Created: https://github.com/user/repo/pull/123\n```\n\n#### /pull-requests:pr-update\n\nUpdate an existing PR's title and description based on actual changes.\n\n**Usage**:\n\n```bash\n/pull-requests:pr-update [pr-number]\n```\n\nIf no PR number is provided, uses the PR for the current branch. This command analyzes the actual changes in the PR and updates its metadata to accurately reflect what's being changed.\n\n#### /pull-requests:pr-comment-review\n\nReview all comments on a pull request and build an actionable task list to address feedback.\n\n**Usage**:\n\n```bash\n/pull-requests:pr-comment-review [pr-number]\n```\n\nIf no PR number is provided, determines it from the current branch. This command checks both review comments and issue comments to create a comprehensive action plan.\n\n#### /pull-requests:merge-conflicts\n\nResolve merge conflicts with intelligent analysis and resolution strategies.\n\n**Usage**:\n\n```bash\n/pull-requests:merge-conflicts\n```\n\nThis command provides a concise, prescriptive workflow for resolving conflicts by analyzing both branches and suggesting appropriate resolution strategies.\n\n### dev-utilities Plugin\n\n#### /dev-utilities:generate-rules\n\nGenerate a high-quality AGENTS.md file for your project using an interactive wizard.\n\n**Usage**:\n\n```bash\n/dev-utilities:generate-rules\n```\n\nThis command will:\n\n- Choose between single AGENTS.md or .cursor/rules/ pattern\n- Analyze your codebase to detect tech stack and architecture\n- Ask key questions about project purpose and conventions\n- Generate AGENTS.md (single file, target \u003c60 lines) OR .cursor/rules/ (multi-file)\n- Create CLAUDE.md → AGENTS.md symlink for Claude Code compatibility\n- Suggest progressive disclosure docs for complex topics\n- Provide quality assessment and line count\n\n**Based on**:\n- [agents.md specification](https://agents.md/) - Universal format for AI assistants\n- [Writing a Good CLAUDE.md](https://www.humanlayer.dev/blog/writing-a-good-claude-md) - Best practices\n\n#### /dev-utilities:agents-md\n\nMigrate existing CLAUDE.md to AGENTS.md following the agents.md specification, creating a symlink for backward compatibility.\n\n**Usage**:\n\n```bash\n/dev-utilities:agents-md\n```\n\nThis command implements the migration pattern: `mv CLAUDE.md AGENTS.md \u0026\u0026 ln -s AGENTS.md CLAUDE.md`\n\n#### /dev-utilities:gh-actions-upgrade\n\nAutomatically detect, analyze, and upgrade GitHub Actions in your repository's workflows.\n\n**Usage**:\n\n```bash\n/dev-utilities:gh-actions-upgrade\n```\n\nThis command will:\n\n1. Scan all workflow files in `.github/workflows/`\n2. Analyze each action to determine current version, fork status, and available upgrades\n3. Generate upgrade plans with breaking change summaries and fork-to-upstream migration recommendations\n4. Apply upgrades to all workflow files\n5. Create a comprehensive PR with upgrade details\n\n#### /dev-utilities:gh-checks\n\nReview and fix GitHub Action check failures on the current branch.\n\n**Usage**:\n\n```bash\n/dev-utilities:gh-checks\n```\n\nThis command will:\n\n1. Check branch and workspace status\n2. Fetch and analyze failing GitHub Action checks\n3. Parse logs to identify root causes\n4. Apply automated fixes when possible\n5. Provide guidance for manual resolution\n\n#### /dev-utilities:git-optimize\n\nOptimize Git repository with branch cleanup and garbage collection.\n\n**Usage**:\n\n```bash\n/dev-utilities:git-optimize\n```\n\nThis command helps you optimize your Git repository using configured aliases and git-trim:\n\n- **Quick cleanup** (after PR merge): Use configured `git cleanup` alias\n- **Weekly maintenance**: Use `git trim` or `git sweep`\n- **Deep optimization** (monthly/quarterly): Use `git optimize`\n- **Full workflow**: Use `git trimall`\n\n#### /dev-utilities:worktree\n\nCreate and manage git worktrees for parallel development work.\n\n**Usage**:\n\n```bash\n/dev-utilities:worktree\n```\n\nThis command uses the git-worktree-creator agent to set up separate working directories for different branches.\n\n#### /dev-utilities:continue\n\nResume work from previous sessions by reviewing planning documents and notebooks.\n\n**Usage**:\n\n```bash\n/dev-utilities:continue\n```\n\nThis command lists and reviews .md files to identify working notebooks and plans for future work, then continues completing items from where you left off.\n\n## Repository Structure\n\n```text\nklauern-skills/\n├── .claude-plugin/\n│   └── marketplace.json              # Marketplace configuration pointing to plugins/*\n├── plugins/\n│   ├── commits/                      # Conventional commit creation plugin\n│   │   ├── .claude-plugin/\n│   │   │   └── plugin.json\n│   │   ├── commands/\n│   │   │   ├── commit.md\n│   │   │   └── commit-push.md\n│   │   └── conventional-commits/     # Skill\n│   │       ├── SKILL.md\n│   │       ├── best-practices.md\n│   │       ├── examples.md\n│   │       ├── format-reference.md\n│   │       └── workflows.md\n│   │\n│   ├── pull-requests/                # PR creation and management plugin\n│   │   ├── .claude-plugin/\n│   │   │   └── plugin.json\n│   │   ├── commands/\n│   │   │   ├── pr.md\n│   │   │   ├── pr-update.md\n│   │   │   ├── pr-comment-review.md\n│   │   │   └── merge-conflicts.md\n│   │   ├── pr-creator/               # Skill\n│   │   │   ├── SKILL.md\n│   │   │   └── references/\n│   │   └── pr-conflict-resolver/     # Skill\n│   │       ├── SKILL.md\n│   │       └── references/\n│   │\n│   └── dev-utilities/                # Development workflow utilities plugin\n│       ├── .claude-plugin/\n│       │   └── plugin.json\n│       ├── commands/\n│       │   ├── generate-rules.md\n│       │   ├── agents-md.md\n│       │   ├── gh-actions-upgrade.md\n│       │   ├── gh-checks.md\n│       │   ├── git-optimize.md\n│       │   ├── worktree.md\n│       │   └── continue.md\n│       ├── claude-md-generator/      # Skill\n│       │   ├── SKILL.md\n│       │   ├── guidelines.md\n│       │   ├── template.md\n│       │   ├── cursor-rules-pattern.md\n│       │   └── progressive-disclosure.md\n│       ├── gh-actions-upgrader/      # Skill\n│       │   ├── SKILL.md\n│       │   └── references/\n│       ├── ci-failure-analyzer/      # Skill\n│       │   ├── SKILL.md\n│       │   └── references/\n│       └── git-optimize/             # Skill\n│           ├── SKILL.md\n│           └── references/\n│\n├── AGENTS.md                         # Project documentation\n├── CLAUDE.md -\u003e AGENTS.md            # Symlink for Claude Code compatibility\n└── README.md\n```\n\nEach plugin is self-contained with its own commands and skills. Skills are defined in directories containing a `SKILL.md` file with instructions and metadata. Commands are markdown files in each plugin's `commands/` directory.\n\n## Development\n\n### Adding New Skills\n\n1. Navigate to the appropriate plugin directory:\n\n```bash\ncd plugins/\u003cplugin-name\u003e\n```\n\n2. Create a new skill directory with `SKILL.md`:\n\n```bash\nmkdir my-new-skill\ntouch my-new-skill/SKILL.md\n```\n\n3. Add skill metadata in the frontmatter:\n\n```yaml\n---\nname: my-new-skill\ndescription: Brief description\nversion: 1.0.0\nauthor: klauern\n---\n```\n\n4. Skills are automatically discovered - no need to register in plugin.json\n\n### Adding New Commands\n\n1. Navigate to the plugin's commands directory:\n\n```bash\ncd plugins/\u003cplugin-name\u003e/commands\n```\n\n2. Create a markdown file for your command:\n\n```bash\ntouch my-command.md\n```\n\n3. Add command metadata in the frontmatter:\n\n```yaml\n---\nallowed-tools: Bash, Read, Grep\ndescription: Command description\n---\n```\n\n4. Define the command behavior in markdown with instructions for Claude\n\n5. Test the command:\n\n```bash\n/\u003cplugin-name\u003e:my-command\n```\n\n### Creating a New Plugin\n\n1. Create plugin directory structure:\n\n```bash\nmkdir -p plugins/my-plugin/.claude-plugin\nmkdir -p plugins/my-plugin/commands\n```\n\n2. Create `plugins/my-plugin/.claude-plugin/plugin.json`:\n\n```json\n{\n  \"name\": \"my-plugin\",\n  \"description\": \"Plugin description\",\n  \"version\": \"1.0.0\",\n  \"author\": {\n    \"name\": \"klauern\",\n    \"email\": \"klauer@gmail.com\"\n  }\n}\n```\n\n3. Add plugin to `.claude-plugin/marketplace.json`:\n\n```json\n{\n  \"plugins\": [\n    {\n      \"name\": \"my-plugin\",\n      \"description\": \"Plugin description\",\n      \"source\": \"./plugins/my-plugin\"\n    }\n  ]\n}\n```\n\n### Marketplace Configuration\n\nEdit `.claude-plugin/marketplace.json` to manage the marketplace:\n\n- `name`: Marketplace identifier\n- `version`: Semantic version number\n- `owner`: Marketplace owner information\n- `plugins`: Array of plugin definitions with names, descriptions, and source paths\n\n## Contributing\n\nFeel free to suggest improvements or report issues.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fklauern%2Fskills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fklauern%2Fskills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fklauern%2Fskills/lists"}