SkillAtlasSkill 详情

commit-work

Opinionated skills shared by @leonardocouy for improving daily work efficiency with Claude Code.

审核状态：已审核Quality 80Security 100

复制安装命令

用 Codex 或 Claude 安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它先审查 Skill 页面再帮你安装。

复制前请先查看来源、License 和安全提示。

项目 README

来源文件：README.md

抓取于 2026年8月15日

Softaworks Agent Skills

Opinionated skills shared by @leonardocouy for improving daily work efficiency with Claude Code. Skills are packaged instructions and scripts that extend agent capabilities across development, documentation, planning, and professional workflows.

Skills follow the Agent Skills format.

🧭 Quick Navigation

🚀 Installation • 📚 Available Skills • 🤖 Agents & Commands • 📖 Skill Structure • 🤝 Contributing • 📄 License • 🔗 Links

🚀 Installation

Quick Install (Recommended)

npx skills add softaworks/agent-toolkit

This method works with multiple AI coding agents (Claude Code, Codex, Cursor, AdaL, etc.)

Register as Plugin Marketplace

Run the following commands in Claude Code:

/plugin marketplace add softaworks/agent-toolkit
/plugin

Install Plugins

Option 1: Via Browse UI

  1. Switch to Marketplaces tab (use arrow keys or Tab)
  2. Select agent-toolkit, press Enter
  3. Browse and select the plugin(s) you want to install
  4. Select Install now

Option 2: Direct Install

# Install specific skill
/plugin install codex@agent-toolkit
/plugin install humanizer@agent-toolkit

# Install specific agent
/plugin install agent-codebase-pattern-finder@agent-toolkit

# Install specific command
/plugin install command-codex-plan@agent-toolkit

Option 3: Ask the Agent

Simply tell Claude Code:

Please install Skills from github.com/softaworks/agent-toolkit

Available Plugins

Each skill, agent, and command is an individual plugin that can be installed separately:

  • Skills → See Available Skills for the full list
  • Agents → See Agents (install as agent-<name>@agent-toolkit)
  • Commands → See Slash Commands (install as command-<name>@agent-toolkit)

Update Plugins

To update plugins to the latest version:

  1. Run /plugin in Claude Code
  2. Switch to Marketplaces tab
  3. Select agent-toolkit
  4. Choose Update marketplace

You can also Enable auto-update to get the latest versions automatically.

Manual Installation

For Claude Code (Manual) — Skills only

cp -r skills/<skill-name> ~/.claude/skills/

For claude.ai — Skills only

Add skills to project knowledge or paste SKILL.md contents into the conversation.

📚 Available Skills

CategorySkillDescription
🤖 AI ToolscodexAdvanced code analysis with GPT-5.2
🤖 AI ToolsgeminiLarge-scale review (200k+ context)
🤖 AI ToolsperplexityWeb search & research
🔮 Metaagent-md-refactorRefactor bloated agent instruction files
🔮 Metacommand-creatorCreate Claude Code slash commands
🔮 Metaplugin-forgeBuild Claude Code plugins & manifests
🔮 Metaskill-judgeEvaluate skill design quality
📝 Documentationbackend-to-frontend-handoff-docsAPI handoff docs for frontend
📝 Documentationc4-architectureC4 architecture diagrams with Mermaid
📝 Documentationcrafting-effective-readmesWrite effective README files
📝 Documentationdraw-ioCreate & edit draw.io diagrams
📝 DocumentationexcalidrawWork with Excalidraw diagrams
📝 Documentationfrontend-to-backend-requirementsDocument API requirements
📝 Documentationmarp-slideProfessional presentation slides
📝 Documentationmermaid-diagramsSoftware diagrams with Mermaid
📝 Documentationwriting-clearly-and-conciselyClear, professional writing
🎨 Design & Frontenddesign-system-starterCreate design systems
🎨 Design & FrontendmuiMaterial-UI v7 patterns
🎨 Design & Frontendopenapi-to-typescriptConvert OpenAPI to TypeScript
🎨 Design & Frontendreact-devType-safe React 18-19 with TypeScript
🎨 Design & Frontendreact-useeffectReact useEffect best practices
🛠️ Developmentdatabase-schema-designerDesign robust database schemas
🛠️ Developmentdependency-updaterSmart dependency management
🛠️ Developmentnaming-analyzerSuggest better variable/function names
🛠️ Developmentlesson-learnedExtract SE lessons from recent code changes
🛠️ Developmentreducing-entropyMinimize codebase size
🛠️ Developmentsession-handoffSeamless AI session transfers
🎯 Planninggame-changing-featuresFind 10x product opportunities
🎯 PlanninggepettoDetailed implementation planning
🎯 Planningrequirements-clarityClarify requirements before coding
🎯 Planningship-learn-nextTurn learning into actionable reps
👔 Professionaldaily-meeting-updateInteractive daily standup generator
👔 Professionaldifficult-workplace-conversationsNavigate difficult conversations
👔 Professionalfeedback-masteryDeliver constructive feedback
👔 Professionalprofessional-communicationTechnical communication guide
🧪 Testingqa-test-plannerComprehensive QA test planning
📦 Gitcommit-workHigh-quality git commits
🔧 Utilitiesdatadog-cliDebug with Datadog logs & metrics
🔧 Utilitiesdomain-name-brainstormerGenerate & check domain names
🔧 UtilitieshumanizerRemove AI writing patterns
🔧 Utilitiesmeme-factoryGenerate memes with API
🔧 UtilitiesjiraNatural language Jira interaction
🔧 Utilitiesweb-to-markdownConvert webpages to Markdown

🤖 Agents & Commands

Requires Claude Code CLI — These agents and commands are exclusive to Claude Code users.

For full access, add the marketplace and install plugins:

/plugin marketplace add softaworks/agent-toolkit
/plugin install codex@agent-toolkit

Agents

Specialized sub-agents that Claude Code can delegate tasks to:

AgentDescription
ascii-ui-mockup-generatorVisualize UI concepts through ASCII mockups
codebase-pattern-finderFind similar implementations and patterns
communication-excellence-coachEmail refinement, tone calibration, roleplay
general-purposeDefault agent for complex multi-step tasks
mermaid-diagram-specialistCreate flowcharts, sequence diagrams, ERDs
ui-ux-designerResearch-backed UI/UX design feedback

Slash Commands

Reusable workflows invoked with /command-name:

CommandDescription
/codex-planCreate implementation plans using Codex 5.2
/compose-emailDraft professional emails
/explain-changes-mental-modelBuild mental model of code changes
/explain-pr-changesGenerate PR summaries
/sync-branchSync feature branch with main
/sync-skills-readmeUpdate README skills table
/viral-tweetOptimize tweet ideas for X engagement

📖 Skill Structure

Each skill contains:

  • SKILL.md - Detailed instructions for the agent (with YAML frontmatter)
  • README.md - User-friendly documentation with examples
  • scripts/ - Helper scripts for automation (optional)
  • references/ - Supporting documentation (optional)

🤝 Contributing

Contributions are welcome! When adding new skills:

  1. Follow the Agent Skills format
  2. Include both SKILL.md (for agents) and README.md (for users)
  3. Add YAML frontmatter to SKILL.md with name: and description: fields
  4. Update this README.md with a link to your skill

📄 License

MIT

🔗 Links

其他

低风险

  • 来源需自行核对维护者身份。
  • 未检测到明显脚本安装指令。
  • 未检测到明显外部权限要求。
  • 未检测到高风险命令。
  • 扫描发现：0 条。

Codex — Git Clone 安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 克隆仓库：git clone https://github.com/softaworks/agent-toolkit.git
  3. 将 "skills/commit-work" 文件夹复制到 Codex 的 skills 目录中。
  4. 重启 Codex 让新的 skill 生效。

Codex — 手动复制安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 从源仓库下载 SKILL.md 及相关文件。
  3. 在 Codex 的 skills 目录中创建新文件夹。
  4. 将所有 skill 文件复制到新文件夹中。
  5. 重启 Codex 让新的 skill 生效。

Claude Code — Git Clone 安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 克隆仓库：git clone https://github.com/softaworks/agent-toolkit.git
  3. 将 "skills/commit-work" 文件夹复制到 Claude Code 的 skills 目录中。
  4. 重启 Claude Code 让新的 skill 生效。

Claude Code — 手动复制安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 从源仓库下载 SKILL.md 及相关文件。
  3. 在 Claude Code 的 skills 目录中创建新文件夹。
  4. 将所有 skill 文件复制到新文件夹中。
  5. 重启 Claude Code 让新的 skill 生效。

Cursor — Git Clone 安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 克隆仓库：git clone https://github.com/softaworks/agent-toolkit.git
  3. 将 "skills/commit-work" 文件夹复制到 Cursor 的 skills 目录中。
  4. 重启 Cursor 让新的 skill 生效。

Cursor — 手动复制安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 从源仓库下载 SKILL.md 及相关文件。
  3. 在 Cursor 的 skills 目录中创建新文件夹。
  4. 将所有 skill 文件复制到新文件夹中。
  5. 重启 Cursor 让新的 skill 生效。

GitHub Copilot — Git Clone 安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 克隆仓库：git clone https://github.com/softaworks/agent-toolkit.git
  3. 将 "skills/commit-work" 文件夹复制到 GitHub Copilot 的 skills 目录中。
  4. 重启 GitHub Copilot 让新的 skill 生效。

GitHub Copilot — 手动复制安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 从源仓库下载 SKILL.md 及相关文件。
  3. 在 GitHub Copilot 的 skills 目录中创建新文件夹。
  4. 将所有 skill 文件复制到新文件夹中。
  5. 重启 GitHub Copilot 让新的 skill 生效。

Windsurf — Git Clone 安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 克隆仓库：git clone https://github.com/softaworks/agent-toolkit.git
  3. 将 "skills/commit-work" 文件夹复制到 Windsurf 的 skills 目录中。
  4. 重启 Windsurf 让新的 skill 生效。

Windsurf — 手动复制安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 从源仓库下载 SKILL.md 及相关文件。
  3. 在 Windsurf 的 skills 目录中创建新文件夹。
  4. 将所有 skill 文件复制到新文件夹中。
  5. 重启 Windsurf 让新的 skill 生效。
查看 SKILL.md 原文
name: commit-work
description: "Create high-quality git commits: review/stage intended changes, split into logical commits, and write clear commit messages (including Conventional Commits). Use when the user asks to commit, craft a commit message, stage changes, or split work into multiple commits."

Commit work

Goal

Make commits that are easy to review and safe to ship:

  • only intended changes are included
  • commits are logically scoped (split when needed)
  • commit messages describe what changed and why

Inputs to ask for (if missing)

  • Single commit or multiple commits? (If unsure: default to multiple small commits when there are unrelated changes.)
  • Commit style: Conventional Commits are required.
  • Any rules: max subject length, required scopes.

Workflow (checklist)

  1. Inspect the working tree before staging
    • git status
    • git diff (unstaged)
    • If many changes: git diff --stat
  2. Decide commit boundaries (split if needed)
    • Split by: feature vs refactor, backend vs frontend, formatting vs logic, tests vs prod code, dependency bumps vs behavior changes.
    • If changes are mixed in one file, plan to use patch staging.
  3. Stage only what belongs in the next commit
    • Prefer patch staging for mixed changes: git add -p
    • To unstage a hunk/file: git restore --staged -p or git restore --staged <path>
  4. Review what will actually be committed
    • git diff --cached
    • Sanity checks:
      • no secrets or tokens
      • no accidental debug logging
      • no unrelated formatting churn
  5. Describe the staged change in 1-2 sentences (before writing the message)
    • "What changed?" + "Why?"
    • If you cannot describe it cleanly, the commit is probably too big or mixed; go back to step 2.
  6. Write the commit message
    • Use Conventional Commits (required):
      • type(scope): short summary
      • blank line
      • body (what/why, not implementation diary)
      • footer (BREAKING CHANGE) if needed
    • Prefer an editor for multi-line messages: git commit -v
    • Use references/commit-message-template.md if helpful.
  7. Run the smallest relevant verification
    • Run the repo's fastest meaningful check (unit tests, lint, or build) before moving on.
  8. Repeat for the next commit until the working tree is clean

Deliverable

Provide:

  • the final commit message(s)
  • a short summary per commit (what/why)
  • the commands used to stage/review (at minimum: git diff --cached, plus any tests run)

发现问题？提交给管理员复核

评分：

评论 (0)

暂无评论，成为第一个评论者吧！