Devkit
Developer toolkit — a collection of coding skills for AI agents, usable across all major platforms.
Skills
| Skill | Description |
|---|
| using-devkit | Devkit entry-point: helps agents discover and invoke the available devkit skills |
| using-dev | Developer entry-point: detects task level (L0-L3) and orchestrates friendly-*, github-*, and superpowers skills end-to-end |
| friendly-python | Python code cleanup: Pyright strict mode, modern typing, automated formatting (ruff), Pylint fix patterns |
| mihomo-proxy-setup | User-space Mihomo proxy installer: Clash subscription, Web UI, dev tool wrappers (Cursor/Copilot/Claude), Linux + macOS |
| github-create-issue | Structured GitHub issue creation with gh CLI — enforces background, impact, acceptance criteria sections and consistent labeling |
| github-issue-workflow | End-to-end GitHub issue development workflow — triage, develop, code review, ship |
| github-product-manager | Product requirement analysis: clarifies feature ideas and turns scoped requirements into GitHub issues |
Installation
One-liner install — pick your platform:
macOS / Linux:
# curl cannot show the interactive menu; specify a platform directly
curl -fsSL https://raw.githubusercontent.com/zhpeng24/devkit/main/scripts/install.sh | bash -s -- claude
# Local clone interactive menu
bash scripts/install.sh
Windows (PowerShell):
# Interactive menu
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/zhpeng24/devkit/main/scripts/install.ps1)))
# Or specify a platform directly
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/zhpeng24/devkit/main/scripts/install.ps1))) -Platform claude
Supported platforms: claude · cursor · copilot · codex · opencode · gemini
Manual installation
Claude Code
claude plugins marketplace add https://github.com/zhpeng24/devkit.git
claude plugins install devkit
Cursor
git clone https://github.com/zhpeng24/devkit.git ~/.cursor/plugins/local/devkit
# Restart Cursor to detect the plugin
Cursor loads the plugin for agent use. In Cursor 4.17, plugin skills may auto-trigger from natural language instead of appearing as slash commands.
GitHub Copilot CLI
git clone https://github.com/zhpeng24/devkit.git ~/.copilot/plugins/devkit
copilot plugin install ~/.copilot/plugins/devkit
Codex
git clone https://github.com/zhpeng24/devkit.git ~/.codex/devkit
mkdir -p ~/.agents/skills
ln -s ~/.codex/devkit/skills ~/.agents/skills/devkit
OpenCode
Add to opencode.json:
{
"plugin": ["devkit@git+https://github.com/zhpeng24/devkit.git"]
}
Gemini CLI
gemini extensions install https://github.com/zhpeng24/devkit.git
What's Inside
friendly-python
A comprehensive Python code cleanup skill that enforces:
- Pyright strict mode with proper venv configuration
- Modern Python 3.12+ —
type statements, built-in generics, X | None
- Automated formatting —
ruff format, ruff check --select I
- Full type annotations — parameters, returns, instance attributes
- Clean imports — no empty
__init__.py, no TYPE_CHECKING, no re-exports
- Pylint fix patterns — unused arguments, broad exceptions, import ordering
- TypedDict / Protocol / Literal over loose
dict / Any
mihomo-proxy-setup
A complete user-space proxy installer and manager:
- Mihomo (Clash.Meta) binary — auto-detects OS and architecture
- Clash subscription integration with auto-update (every 30 min)
- MetaCubeXD Web UI panel for managing proxy rules
- Proxy wrappers —
with-proxy, proxy-agent, proxy-copilot, proxy-claude
- Service management — systemd (Linux) / launchd (macOS) user services
- Uninstall — full cleanup of all files, services, and configuration
- No root required — everything runs in user space
github-create-issue
A structured GitHub issue template skill that enforces:
- 7-section template — 背景, 已造成问题, 当前状态, 预期改动, 影响范围, 关联, 验收标准
- Standardized labels —
bug, optimization, architecture, innovation, tech-debt, documentation, security
- Title convention —
[模块] 简述问题或改动
- Section trimming — auto-adapt required sections by issue type
gh CLI execution — creates labels if missing, generates full gh issue create command
github-issue-workflow
An end-to-end development workflow skill that enforces:
