From 1dbac591f70501903592aa58359afb03948b432e Mon Sep 17 00:00:00 2001 From: wd041216-bit <258555668+wd041216-bit@users.noreply.github.com> Date: Tue, 17 Mar 2026 23:48:40 -0400 Subject: [PATCH] feat: add openclaw-github-repo-commander skill A 7-stage super workflow for comprehensive GitHub repository management. Targets staged branch as required by CONTRIBUTING.md. README.skills.md updated via npm start. --- docs/README.skills.md | 1 + .../openclaw-github-repo-commander/SKILL.md | 99 +++++++++++++++++++ 2 files changed, 100 insertions(+) create mode 100644 skills/openclaw-github-repo-commander/SKILL.md diff --git a/docs/README.skills.md b/docs/README.skills.md index e0857e9b2..e09e64874 100644 --- a/docs/README.skills.md +++ b/docs/README.skills.md @@ -177,6 +177,7 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-skills) for guidelines on how to | [nuget-manager](../skills/nuget-manager/SKILL.md) | Manage NuGet packages in .NET projects/solutions. Use this skill when adding, removing, or updating NuGet package versions. It enforces using `dotnet` CLI for package management and provides strict procedures for direct file edits only when updating versions. | None | | [oo-component-documentation](../skills/oo-component-documentation/SKILL.md) | Create or update standardized object-oriented component documentation using a shared template plus mode-specific guidance for new and existing docs. | `assets/documentation-template.md`
`references/create-mode.md`
`references/update-mode.md` | | [openapi-to-application-code](../skills/openapi-to-application-code/SKILL.md) | Generate a complete, production-ready application from an OpenAPI specification | None | +| [openclaw-github-repo-commander](../skills/openclaw-github-repo-commander/SKILL.md) | A 7-stage super workflow for comprehensive GitHub repository management. Use this skill when:
- Auditing a GitHub repository for low-value files, duplicate skills, or hardcoded secrets
- Cleaning up a repository (removing junk files, empty directories, node_modules commits)
- Reviewing or creating pull requests with structured analysis
- Refactoring a codebase using a systematic multi-stage approach
- Performing competitor analysis against similar open-source projects
- Running /super-workflow on any repo URL for deep optimization
- The user says "optimize my repo", "clean up this library", "audit my GitHub repo", or "compare with competitors" | None | | [pdftk-server](../skills/pdftk-server/SKILL.md) | Skill for using the command-line tool pdftk (PDFtk Server) for working with PDF files. Use when asked to merge PDFs, split PDFs, rotate pages, encrypt or decrypt PDFs, fill PDF forms, apply watermarks, stamp overlays, extract metadata, burst documents into pages, repair corrupted PDFs, attach or extract files, or perform any PDF manipulation from the command line. | `references/download.md`
`references/pdftk-cli-examples.md`
`references/pdftk-man-page.md`
`references/pdftk-server-license.md`
`references/third-party-materials.md` | | [penpot-uiux-design](../skills/penpot-uiux-design/SKILL.md) | Comprehensive guide for creating professional UI/UX designs in Penpot using MCP tools. Use this skill when: (1) Creating new UI/UX designs for web, mobile, or desktop applications, (2) Building design systems with components and tokens, (3) Designing dashboards, forms, navigation, or landing pages, (4) Applying accessibility standards and best practices, (5) Following platform guidelines (iOS, Android, Material Design), (6) Reviewing or improving existing Penpot designs for usability. Triggers: "design a UI", "create interface", "build layout", "design dashboard", "create form", "design landing page", "make it accessible", "design system", "component library". | `references/accessibility.md`
`references/component-patterns.md`
`references/platform-guidelines.md`
`references/setup-troubleshooting.md` | | [php-mcp-server-generator](../skills/php-mcp-server-generator/SKILL.md) | Generate a complete PHP Model Context Protocol server project with tools, resources, prompts, and tests using the official PHP SDK | None | diff --git a/skills/openclaw-github-repo-commander/SKILL.md b/skills/openclaw-github-repo-commander/SKILL.md new file mode 100644 index 000000000..69562c926 --- /dev/null +++ b/skills/openclaw-github-repo-commander/SKILL.md @@ -0,0 +1,99 @@ +--- +name: openclaw-github-repo-commander +description: | + A 7-stage super workflow for comprehensive GitHub repository management. Use this skill when: + - Auditing a GitHub repository for low-value files, duplicate skills, or hardcoded secrets + - Cleaning up a repository (removing junk files, empty directories, node_modules commits) + - Reviewing or creating pull requests with structured analysis + - Refactoring a codebase using a systematic multi-stage approach + - Performing competitor analysis against similar open-source projects + - Running /super-workflow on any repo URL for deep optimization + - The user says "optimize my repo", "clean up this library", "audit my GitHub repo", or "compare with competitors" +--- +# OpenClaw GitHub Repo Commander + +A 7-stage super workflow for comprehensive GitHub repository management, cleanup, and optimization. + +## Overview + +This skill provides a structured, repeatable 7-stage methodology for auditing, cleaning, and optimizing GitHub repositories. It combines automated scripts with AI-driven analysis to identify issues, compare against competitors, and deliver measurable improvements. + +The workflow is inspired by the super-workflow pattern and adapted specifically for GitHub repository operations using the `gh` CLI. + +## When to Use This Skill + +- Use when a repository has accumulated technical debt (junk files, duplicates, secrets) +- Use when you want a structured PR review process with competitor benchmarking +- Use when creating a new project and want to establish quality standards from day one +- Use when the user asks to "audit", "clean up", or "optimize" any GitHub repository + +## How It Works + +### Stage 1: Intake +Clone the repository, define success criteria, and establish baseline metrics (file count, size, skill count). + +### Stage 2: Execution +Run the automated audit script (`scripts/repo-audit.sh`) to check for: +- Hardcoded secrets and credentials +- Tracked `node_modules/` or build artifacts +- Empty directories +- Large files (>1MB) +- Missing `.gitignore` rules +- Broken internal links + +### Stage 3: Reflection +Deep manual review of content quality, documentation consistency, and structural issues beyond what automation catches. + +### Stage 4: Competitor Analysis +Search GitHub for similar repositories, compare documentation standards, feature coverage, and community adoption metrics. + +### Stage 5: Synthesis +Consolidate findings from Stages 3–4 into a prioritized action plan (P0/P1/P2). + +### Stage 6: Iteration +Execute the action plan: delete low-value files, fix security issues, upgrade documentation, add missing structure. + +### Stage 7: Validation +Re-run the audit script, verify all changes, push to GitHub, and report results. + +## Examples + +### Example 1: Full Repository Audit + +``` +/openclaw-github-repo-commander https://github.com/owner/my-repo +``` + +The skill will run all 7 stages and produce a detailed report with before/after metrics. + +### Example 2: Quick Cleanup + +``` +Clean up my GitHub repo at https://github.com/owner/my-repo — remove junk files and fix secrets +``` + +### Example 3: Competitor Benchmarking + +``` +Compare https://github.com/owner/my-skill with top similar repos on GitHub +``` + +## Best Practices + +- ✅ Always run Stage 7 validation before pushing changes +- ✅ Use the automated audit script for consistent, repeatable checks +- ✅ Commit changes with semantic commit messages (`chore:`, `fix:`, `docs:`) +- ❌ Don't skip Stage 4 — competitor analysis often reveals blind spots +- ❌ Don't commit `node_modules/` or build artifacts + +## Security & Safety Notes + +- The audit script (`scripts/repo-audit.sh`) scans for common secret patterns (`ghp_`, `sk-`, `AKIA`, etc.) +- All operations use the `gh` CLI with the user's existing authentication — no credentials are stored +- The skill excludes `.github/workflows/` from secret scanning to avoid false positives + +## Source + +**Repository**: [wd041216-bit/openclaw-github-repo-commander](https://github.com/wd041216-bit/openclaw-github-repo-commander) + +**License**: MIT