180 lines
4.6 KiB
Markdown
180 lines
4.6 KiB
Markdown
# Installation Guide
|
|
|
|
This guide provides detailed instructions for installing the McKinsey/BCG Style Visualization skill in Claude Code.
|
|
|
|
## Prerequisites
|
|
|
|
- Claude Code installed and configured
|
|
- Git installed (for cloning method)
|
|
- Basic familiarity with command line (optional)
|
|
|
|
## Installation Methods
|
|
|
|
### Method 1: Clone Repository (Recommended)
|
|
|
|
This method is recommended as it allows you to easily update the skill by pulling changes from the repository.
|
|
|
|
#### For Personal Skills (Available in All Projects)
|
|
|
|
```bash
|
|
# Clone to your personal skills directory
|
|
git clone https://github.com/kgraph57/mckinsey-style-visualization-skill.git ~/.claude/skills/mckinsey-style-visualization
|
|
```
|
|
|
|
#### For Project-Specific Skills
|
|
|
|
```bash
|
|
# Navigate to your project directory
|
|
cd /path/to/your/project
|
|
|
|
# Clone to project skills directory
|
|
git clone https://github.com/kgraph57/mckinsey-style-visualization-skill.git .claude/skills/mckinsey-style-visualization
|
|
```
|
|
|
|
### Method 2: Direct Download
|
|
|
|
If you prefer not to use Git, you can download the skill file directly.
|
|
|
|
#### For Personal Skills
|
|
|
|
```bash
|
|
# Create the skills directory
|
|
mkdir -p ~/.claude/skills/mckinsey-style-visualization
|
|
|
|
# Download SKILL.md
|
|
curl -o ~/.claude/skills/mckinsey-style-visualization/SKILL.md https://raw.githubusercontent.com/kgraph57/mckinsey-style-visualization-skill/main/SKILL.md
|
|
```
|
|
|
|
#### For Project-Specific Skills
|
|
|
|
```bash
|
|
# Navigate to your project directory
|
|
cd /path/to/your/project
|
|
|
|
# Create the skills directory
|
|
mkdir -p .claude/skills/mckinsey-style-visualization
|
|
|
|
# Download SKILL.md
|
|
curl -o .claude/skills/mckinsey-style-visualization/SKILL.md https://raw.githubusercontent.com/kgraph57/mckinsey-style-visualization-skill/main/SKILL.md
|
|
```
|
|
|
|
### Method 3: Manual Download
|
|
|
|
1. Visit the [GitHub repository](https://github.com/kgraph57/mckinsey-style-visualization-skill)
|
|
2. Click on `SKILL.md`
|
|
3. Click the "Raw" button
|
|
4. Save the file to your computer
|
|
5. Create the appropriate directory:
|
|
- Personal: `~/.claude/skills/mckinsey-style-visualization/`
|
|
- Project: `.claude/skills/mckinsey-style-visualization/`
|
|
6. Move the downloaded `SKILL.md` file into the directory
|
|
|
|
## Verification
|
|
|
|
After installation, verify that the skill is available:
|
|
|
|
1. Open Claude Code
|
|
2. Type `/` to see available commands
|
|
3. Look for `/mckinsey-style-visualization` in the list
|
|
|
|
Alternatively, ask Claude:
|
|
```
|
|
What skills are available?
|
|
```
|
|
|
|
The skill should appear in the list with its description.
|
|
|
|
## Updating the Skill
|
|
|
|
### If Installed via Git Clone
|
|
|
|
```bash
|
|
# Navigate to the skill directory
|
|
cd ~/.claude/skills/mckinsey-style-visualization
|
|
|
|
# Pull the latest changes
|
|
git pull
|
|
```
|
|
|
|
### If Installed via Direct Download
|
|
|
|
Re-download the `SKILL.md` file using the same method as installation.
|
|
|
|
## Troubleshooting
|
|
|
|
### Skill Not Appearing
|
|
|
|
If the skill doesn't appear in Claude Code:
|
|
|
|
1. **Check the directory structure:**
|
|
```bash
|
|
# For personal skills
|
|
ls -la ~/.claude/skills/mckinsey-style-visualization/
|
|
|
|
# For project skills
|
|
ls -la .claude/skills/mckinsey-style-visualization/
|
|
```
|
|
|
|
You should see `SKILL.md` in the directory.
|
|
|
|
2. **Verify the file content:**
|
|
```bash
|
|
head -n 20 ~/.claude/skills/mckinsey-style-visualization/SKILL.md
|
|
```
|
|
|
|
The file should start with YAML frontmatter (between `---` markers).
|
|
|
|
3. **Restart Claude Code:**
|
|
Close and reopen Claude Code to ensure it picks up the new skill.
|
|
|
|
4. **Check for character budget issues:**
|
|
If you have many skills, they may exceed the character budget. Run `/context` to check for warnings about excluded skills.
|
|
|
|
### Skill Not Triggering Automatically
|
|
|
|
If Claude doesn't use the skill automatically when expected:
|
|
|
|
1. Try invoking it directly with `/mckinsey-style-visualization`
|
|
2. Make your request more specific to match the skill description
|
|
3. Check that the skill description includes keywords you're using
|
|
|
|
### Permission Issues
|
|
|
|
If you encounter permission errors when creating directories:
|
|
|
|
```bash
|
|
# For personal skills, ensure the .claude directory exists
|
|
mkdir -p ~/.claude/skills
|
|
|
|
# Check permissions
|
|
ls -ld ~/.claude
|
|
```
|
|
|
|
## Uninstallation
|
|
|
|
To remove the skill:
|
|
|
|
```bash
|
|
# For personal skills
|
|
rm -rf ~/.claude/skills/mckinsey-style-visualization
|
|
|
|
# For project skills
|
|
rm -rf .claude/skills/mckinsey-style-visualization
|
|
```
|
|
|
|
## Support
|
|
|
|
If you encounter issues not covered in this guide:
|
|
|
|
1. Check the [README](README.md) for usage instructions
|
|
2. Review the [SKILL.md](SKILL.md) for detailed documentation
|
|
3. Open an issue on [GitHub](https://github.com/kgraph57/mckinsey-style-visualization-skill/issues)
|
|
|
|
## Next Steps
|
|
|
|
After installation, see the [README](README.md) for:
|
|
- Usage examples
|
|
- Visualization types
|
|
- Design principles
|
|
- Quality checklist
|