{"id":35492926,"url":"https://github.com/huangwb8/skills","last_synced_at":"2026-05-08T01:04:28.148Z","repository":{"id":331580211,"uuid":"1127232422","full_name":"huangwb8/skills","owner":"huangwb8","description":"General Skills Development Pipeline - Claude Code \u0026 Codex","archived":false,"fork":false,"pushed_at":"2026-01-10T06:26:38.000Z","size":166,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-11T01:51:28.018Z","etag":null,"topics":["ai","claude","claude-code","claude-skills","codex-cli","codex-skills"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/huangwb8.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2026-01-03T13:11:28.000Z","updated_at":"2026-01-10T06:26:41.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/huangwb8/skills","commit_stats":null,"previous_names":["huangwb8/skills"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/huangwb8/skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huangwb8%2Fskills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huangwb8%2Fskills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huangwb8%2Fskills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huangwb8%2Fskills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/huangwb8","download_url":"https://codeload.github.com/huangwb8/skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huangwb8%2Fskills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28399504,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T14:36:09.778Z","status":"ssl_error","status_checked_at":"2026-01-13T14:35:19.697Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["ai","claude","claude-code","claude-skills","codex-cli","codex-skills"],"created_at":"2026-01-03T16:14:57.603Z","updated_at":"2026-05-08T01:04:28.122Z","avatar_url":"https://github.com/huangwb8.png","language":"Python","funding_links":[],"categories":["Claude Code Skills"],"sub_categories":["开发辅助"],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Skills 开发流水线\n\n[![Version](https://img.shields.io/github/v/tag/huangwb8/skills?label=version\u0026sort=semver)](https://github.com/huangwb8/skills/releases)\n[![Standard](https://img.shields.io/badge/Agent%20Skills-Standard%20v1.0-blue.svg)](https://agentskills.io)\n[![Platforms](https://img.shields.io/badge/platform-Claude%20Code%20%7C%20Codex%20%7C%20Cursor-lightgrey.svg)](#平台兼容性)\n[![Built with](https://img.shields.io/badge/built%20with-Python%203.10%2B-orange.svg)](https://www.python.org/)\n\n[中文](README.md) | [English](README_EN.md)\n\n\u003cstrong\u003e遵循 Agent Skills 开放标准的可复用 AI 技能库与技能开发流水线\u003c/strong\u003e\n\n\u003c/div\u003e\n\n这是一个遵循 Agent Skills 开放标准的技能库与开发流水线，覆盖 skills 的创建、测试、文档化、安装、发布和缺陷反馈。仓库内既包含可直接安装使用的通用 skills，也包含维护这些 skills 所需的约束、脚本和协作流程。\n\n## 🎯 这个仓库适合谁\n\n- 想把一组 skills 复制安装到系统级目录，在任意项目里都能触发的人\n- 想开发、优化、测试、发布自己 skills 的维护者\n- 想复用本仓库里的工程约束、文档约束和质量流程的人\n- 想基于 Agent Skills 标准，兼容 Claude Code、Codex、Cursor 等平台的人\n\n## 💡 推荐开发环境\n\n### 🧰 VS Code + Claude Code / Codex 插件\n\n推荐使用 VS Code 配合 Claude Code 或 Codex 插件进行技能开发、测试和维护。\n\n| 优势 | 说明 |\n|------|------|\n| 原生技能集成 | 自动从系统级 skills 目录加载已安装技能 |\n| 实时验证 | 直接用自然语言测试技能触发与执行效果 |\n| 上下文感知编辑 | AI 能结合项目结构理解技能、脚本和文档之间的关系 |\n| 集成工作流 | 编辑、测试、安装、迭代可以在同一环境中完成 |\n| 文档协同维护 | 便于同步维护 `SKILL.md`、`README.md`、`config.yaml` 与 `CHANGELOG.md` |\n\n📺 [观看演示视频（Bilibili）](https://www.bilibili.com/video/BV1tpcezbERB)\n\n## ⚡ AI 算力\n\n仓库相关的 AI 算力说明与使用背景，可参考下面的视频：\n\n📺 [观看 AI 算力介绍视频（Bilibili）](https://www.bilibili.com/video/BV1a7ZLBuE5z)\n\n## 🧩 核心技能\n\n仓库根目录下可直接安装的技能有 12 个：\n\n| 技能 | 主要用途 | 适用场景 |\n|------|----------|----------|\n| `init-project` | 初始化项目指令文件 | 为新项目生成 `AGENTS.md`、`CLAUDE.md`、`README.md`、`CHANGELOG.md`、`.gitignore`，并补齐 `docs/` 与 `docs/plans/` |\n| `install-bensz-skills` | 系统级安装 skills | 把本仓库 skills 复制到 `~/.codex/skills/`、`~/.claude/skills/` |\n| `write-skill-readme` | 生成技能用户文档 | 为单个 skill 产出面向使用者的 `README.md` |\n| `auto-test-skill` | skill 级批判性测试 | 测试某个 skill 的流程设计、输出质量和鲁棒性 |\n| `auto-test-project` | 项目级批判性测试 | 对整个项目做多轮问题发现、修复和复验 |\n| `better-prompt` | Prompt 优化 | 把简陋 prompt 重写成更清晰、可执行的版本 |\n| `awesome-code` | 多代理协作开发 | 任务拆解、三层代理分派、required agent 门禁与并行推进 |\n| `parallel-vibe` | 多工作区并行尝试 | 同一指令开多个独立工作区并行探索方案 |\n| `git-commit` | Git 提交自动化 | 生成 conventional commit，按需自动 push |\n| `git-pr-review` | GitHub PR 只读审查 | 判断某个 PR 是否值得 merge，输出结构化报告 |\n| `git-publish-release` | GitHub Release 发布 | 生成 release notes 并创建 release |\n| `bensz-collect-bugs` | 收集并公开上报 skill 设计缺陷 | 规范化记录 bug，并在用户明确要求时用 `gh` 公开上报 |\n\n想看每个 skill 的详细用法，可以直接进入对应目录阅读其 `README.md` 和 `SKILL.md`。\n\n## ✨ 仓库能力\n\n- 一套面向多平台的 Agent Skills 标准化开发方式\n- 一组可直接使用的通用 skills\n- 一条完整维护链路：创建、测试、文档化、安装、发布、缺陷反馈\n- 面向系统级可发现性的安装机制\n- 面向长期演进的工程约束：KISS、YAGNI、DRY、Single Source of Truth、有机更新\n\n## 🌐 平台兼容性\n\n根据本仓库约定与 Agent Skills 生态，当前重点兼容平台包括：\n\n| 平台 | 状态 | 常见技能目录 |\n|------|------|--------------|\n| [Claude Code](https://code.anthropic.com) | 已验证 | `~/.claude/skills/` |\n| [OpenAI Codex](https://openai.com/index/introducing-codex/) | 已验证 | `~/.codex/skills/` |\n| Cursor | 兼容 | `~/.cursor/skills/` |\n| GitHub | 兼容 | `.github/skills/` |\n| VS Code | 兼容 | `.vscode/skills/` |\n| Amp | 兼容 | 依平台约定 |\n| Letta | 兼容 | 依平台约定 |\n| Goose | 兼容 | 依平台约定 |\n\n## 🚀 快速开始\n\n### ⚡ 推荐：一行远程安装\n\n无需先克隆仓库，直接用 `@install/install.py` 安装到系统级目录。这个安装器是单文件 Python 脚本，只依赖标准库；它会从 GitHub zip 包下载远程源、按 MD5 跳过未变化的 skill，并写入安装清单。\n\n| 平台 | 命令 |\n|------|------|\n| 全平台（Python） | `python -c \"import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/huangwb8/skills/main/@install/install.py').read())\"` |\n| macOS / Linux 备用 | `python3 -c \"import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/huangwb8/skills/main/@install/install.py').read())\"` |\n\n默认安装的远程源：\n\n- `general`：`huangwb8/skills` 通用技能\n- `research`：`huangwb8/ChineseResearchLaTeX` 科研技能\n- `anthropic-docs`：`anthropics/skills` 官方文档处理技能\n\n默认安装位置：\n\n- `~/.claude/skills/`\n- `~/.codex/skills/`\n\n常用参数：\n\n```bash\n# 只安装本仓库通用技能\npython -c \"import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/huangwb8/skills/main/@install/install.py').read())\" --source general\n\n# 只安装到 Codex 或 Claude Code\npython -c \"import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/huangwb8/skills/main/@install/install.py').read())\" --codex\npython -c \"import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/huangwb8/skills/main/@install/install.py').read())\" --claude\n\n# 预览安装动作，不写入文件\npython -c \"import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/huangwb8/skills/main/@install/install.py').read())\" --check\n\n# 使用中文安装输出\npython -c \"import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/huangwb8/skills/main/@install/install.py').read())\" --lang zh\n```\n\n### 🛠️ 本地开发安装\n\n如果你已经克隆仓库，或正在开发本仓库里的 skills，可以使用本地安装脚本。它会优先从当前目录自动识别 `pipelines/skills/`、`skills/` 或当前目录本身。\n\n```bash\ngit clone https://github.com/huangwb8/skills.git\ncd skills\npython3 install-bensz-skills/scripts/install.py\n```\n\n如果你只想装到某一个平台：\n\n```bash\npython3 install-bensz-skills/scripts/install.py --codex\npython3 install-bensz-skills/scripts/install.py --claude\n```\n\n如果安装器已经系统级安装，也可以在其它项目中直接调用已安装脚本，并显式指定源目录：\n\n```bash\npython3 ~/.codex/skills/install-bensz-skills/scripts/install.py --source ./skills\npython3 ~/.claude/skills/install-bensz-skills/scripts/install.py --source ./skills\n```\n\n### 🤖 让 AI 调用安装 skill\n\n在 Claude Code 或 Codex 中打开本仓库后，可以直接说：\n\n```text\n请使用 install-bensz-skills skill 将当前仓库中的 skills 安装到系统级目录，确保它们在任意项目中可被发现。\n```\n\n这适合你想把“安装动作”也放进自然语言工作流里时使用。\n\n## 如何贡献？\n\n本项目暂时不支持常规pr。如果确有需求，需要请示 [huangwb8](https://github.com/huangwb8)。\n\n## 🔗 相关资源\n\n- [Agent Skills 开放标准](https://agentskills.io)\n- [AGENTS.md](AGENTS.md)\n- [CLAUDE.md](CLAUDE.md)\n- [install-bensz-skills 用户指南](install-bensz-skills/README.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuangwb8%2Fskills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhuangwb8%2Fskills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuangwb8%2Fskills/lists"}