cc-general-skills

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# Claude Code General Skills

A collection of general-purpose skills for [Claude Code](https://claude.com/claude-code).

## Skills

### debug

Apply systematic debugging methodology using medical differential diagnosis principles.

**Key Features:**
- **7-Step Medical Diagnosis Approach**: Systematic workflow from observation to prevention
- **Evidence-Based Investigation**: Prioritize facts over assumptions
- **Differential Diagnosis Lists**: Enumerate all possible failure points before elimination
- **Chain-of-Thought Reasoning**: Transparent deductive process with experimental verification
- **Comprehensive Documentation**: Templates for investigation logs and post-mortem reports

**Triggers on:**
- AI modifies working code and anomalies occur
- Users report unexpected test results or execution failures

**Workflow:**
1. Observe Without Preconception
2. Classify and Isolate Facts
3. Build Differential Diagnosis List
4. Apply Elimination and Deductive Reasoning
5. Experimental Verification and Investigation
6. Locate and Implement Fix
7. Prevention Mechanism

[View skill documentation](https://github.com/iciakky/cc-general-skills/blob/HEAD/skills/debug/SKILL.md)

### error-troubleshooter

Automatically troubleshoot unexpected results and command/script errors without user request.

**Key Features:**
- **Proactive Investigation**: Automatically activates on unexpected behavior or errors
- **Dual-Mode Troubleshooting**: Handles both explicit failures (stderr, exceptions) and silent anomalies (missing expected effects)
- **Systematic Approach**: Uses error template extraction, hypothesis testing, and web research
- **Scientific Methodology**: Employs "bold hypotheses, careful verification" principles
- **Token Efficient**: Leverages subagents and file-based debugging for complex investigations

**Triggers on:**
- Command succeeded but expected effect didn't happen
- Missing expected errors (e.g., test designed to fail but passed)
- Wrong or unexpected output
- Silent failures
- Explicit errors (SDK/API errors, exceptions, build failures)

[View skill documentation](https://github.com/iciakky/cc-general-skills/blob/HEAD/skills/error-troubleshooter/SKILL.md)

## Installation

### Option 1: Plugin Installation (Recommended)

Install directly using Claude Code's plugin system:

```bash
# Add this repository as a marketplace
/plugin marketplace add iciakky/cc-general-skills

# Install the plugin
/plugin install cc-general-skills@cc-general-skills

# Restart Claude Code
```

### Option 2: Manual Installation

**Install all skills (Unix/Linux/macOS):**
```bash
git clone https://github.com/iciakky/cc-general-skills.git
cp -r cc-general-skills/skills/debug ~/.claude/skills/
cp -r cc-general-skills/skills/error-troubleshooter ~/.claude/skills/
```

**Install all skills (Windows PowerShell):**
```powershell
git clone https://github.com/iciakky/cc-general-skills.git
Copy-Item -Recurse cc-general-skills\skills\debug $env:USERPROFILE\.claude\skills\
Copy-Item -Recurse cc-general-skills\skills\error-troubleshooter $env:USERPROFILE\.claude\skills\
```

**Install specific skills only:**
Replace `debug` or `error-troubleshooter` with the skill you want to install.

Then restart Claude Code.

### Option 3: Download Release

1. Download the latest skill zip files from [Releases](https://github.com/iciakky/cc-general-skills/releases):
   - `debug.zip` - Systematic debugging with medical diagnosis methodology
   - `error-troubleshooter.zip` - Automatic error troubleshooting
2. Extract to `~/.claude/skills/` (or `%USERPROFILE%\.claude\skills\` on Windows)
3. Restart Claude Code

## Development

### Repository Structure

```
cc-general-skills/
├── .claude-plugin/          # Plugin configuration
│   ├── plugin.json          # Plugin metadata
│   └── marketplace.json     # Marketplace catalog
├── skills/                  # Skills directory
│   ├── debug/
│   │   ├── SKILL.md         # Main skill definition
│   │   ├── references/      # Investigation templates and bug patterns
│   │   ├── assets/          # Report templates
│   │   └── repackage.py     # Build script
│   └── error-troubleshooter/
│       ├── SKILL.md         # Main skill definition
│       ├── references/      # Reference documentation
│       ├── assets/          # Templates and resources
│       └── repackage.py     # Build script
├── .gitignore
├── LICENSE
└── README.md
```

### Repackaging a Skill

Each skill includes a `repackage.py` script for creating distributable zip files:

```bash
# Repackage debug skill
cd skills/debug
python repackage.py

# Repackage error-troubleshooter skill
cd ../error-troubleshooter
python repackage.py
```

This creates `debug.zip` and `error-troubleshooter.zip` in the `skills/` directory.

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## License

MIT License - see LICENSE file for details.

## Credits

Created with Claude Code's skill-creator tool.

Claude Code General Skills

A collection of general-purpose skills for Claude Code.

Skills

debug

Apply systematic debugging methodology using medical differential diagnosis principles.

Key Features:

7-Step Medical Diagnosis Approach: Systematic workflow from observation to prevention
Evidence-Based Investigation: Prioritize facts over assumptions
Differential Diagnosis Lists: Enumerate all possible failure points before elimination
Chain-of-Thought Reasoning: Transparent deductive process with experimental verification
Comprehensive Documentation: Templates for investigation logs and post-mortem reports

Triggers on:

AI modifies working code and anomalies occur
Users report unexpected test results or execution failures

Workflow:

Observe Without Preconception
Classify and Isolate Facts
Build Differential Diagnosis List
Apply Elimination and Deductive Reasoning
Experimental Verification and Investigation
Locate and Implement Fix
Prevention Mechanism

View skill documentation

error-troubleshooter

Automatically troubleshoot unexpected results and command/script errors without user request.

Key Features:

Proactive Investigation: Automatically activates on unexpected behavior or errors
Dual-Mode Troubleshooting: Handles both explicit failures (stderr, exceptions) and silent anomalies (missing expected effects)
Systematic Approach: Uses error template extraction, hypothesis testing, and web research
Scientific Methodology: Employs "bold hypotheses, careful verification" principles
Token Efficient: Leverages subagents and file-based debugging for complex investigations

Triggers on:

Command succeeded but expected effect didn't happen
Missing expected errors (e.g., test designed to fail but passed)
Wrong or unexpected output
Silent failures
Explicit errors (SDK/API errors, exceptions, build failures)

View skill documentation

Installation

Option 1: Plugin Installation (Recommended)

Install directly using Claude Code's plugin system:

# Add this repository as a marketplace
/plugin marketplace add iciakky/cc-general-skills

# Install the plugin
/plugin install cc-general-skills@cc-general-skills

# Restart Claude Code

Option 2: Manual Installation

Install all skills (Unix/Linux/macOS):

git clone https://github.com/iciakky/cc-general-skills.git
cp -r cc-general-skills/skills/debug ~/.claude/skills/
cp -r cc-general-skills/skills/error-troubleshooter ~/.claude/skills/

Install all skills (Windows PowerShell):

git clone https://github.com/iciakky/cc-general-skills.git
Copy-Item -Recurse cc-general-skills\skills\debug $env:USERPROFILE\.claude\skills\
Copy-Item -Recurse cc-general-skills\skills\error-troubleshooter $env:USERPROFILE\.claude\skills\

Install specific skills only: Replace debug or error-troubleshooter with the skill you want to install.

Then restart Claude Code.

Option 3: Download Release

Download the latest skill zip files from Releases:
- debug.zip - Systematic debugging with medical diagnosis methodology
- error-troubleshooter.zip - Automatic error troubleshooting
Extract to ~/.claude/skills/ (or %USERPROFILE%\.claude\skills\ on Windows)
Restart Claude Code

Development

Repository Structure

cc-general-skills/
├── .claude-plugin/          # Plugin configuration
│   ├── plugin.json          # Plugin metadata
│   └── marketplace.json     # Marketplace catalog
├── skills/                  # Skills directory
│   ├── debug/
│   │   ├── SKILL.md         # Main skill definition
│   │   ├── references/      # Investigation templates and bug patterns
│   │   ├── assets/          # Report templates
│   │   └── repackage.py     # Build script
│   └── error-troubleshooter/
│       ├── SKILL.md         # Main skill definition
│       ├── references/      # Reference documentation
│       ├── assets/          # Templates and resources
│       └── repackage.py     # Build script
├── .gitignore
├── LICENSE
└── README.md

Repackaging a Skill

Each skill includes a repackage.py script for creating distributable zip files:

# Repackage debug skill
cd skills/debug
python repackage.py

# Repackage error-troubleshooter skill
cd ../error-troubleshooter
python repackage.py

This creates debug.zip and error-troubleshooter.zip in the skills/ directory.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE file for details.

Credits

Created with Claude Code's skill-creator tool.