Skip to content
Skills Library
AI & agents · Learning & explanation

working-with-claude-code

/working-with-claude-code

Use when working with Claude Code CLI, plugins, hooks, MCP servers, skills, configuration, or any Claude Code feature - provides comprehensive official documentation for all aspects of Claude Code

Licence
MIT
Last repository change
26.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
152
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • Paczka skrócona: część plików jest zbyt duża or wykonywalna. Pełny folder jest w repozytorium.

What it does and when to use it

Use when working with Claude Code CLI, plugins, hooks, MCP servers, skills, configuration, or any Claude Code feature - provides comprehensive official documentation for all aspects of Claude Code

Original author description

Use when working with Claude Code CLI, plugins, hooks, MCP servers, skills, configuration, or any Claude Code feature - provides comprehensive official documentation for all aspects of Claude Code

How it works

  1. Overview
  2. When to Use
  3. Quick Reference
  4. Documentation Organization
  5. Workflow
  6. Updating Documentation
  7. Common Patterns
  8. Manual notes (references/howto/)
  9. What This Skill Does NOT Do
  10. Red Flags
Original SKILL.md headings · 194 lines, 948 words
SKILL.md preview
---
name: working-with-claude-code
description: Use when working with Claude Code CLI, plugins, hooks, MCP servers, skills, configuration, or any Claude Code feature - provides comprehensive official documentation for all aspects of Claude Code
metadata:
  last_updated: "2026-08-12"
---

# Working with Claude Code

## Overview

This skill provides complete, authoritative documentation for Claude Code directly from code.claude.com. Instead of guessing about configuration paths, API structures, or feature capabilities, read the official docs stored in this skill's references directory.

## When to Use

Use this skill when:
- Creating or configuring Claude Code plugins
- Setting up MCP servers
- Working with hooks (pre-commit, session-start, etc.)
- Writing or testing skills
- Configuring Claude Code settings
- Troubleshooting Claude Code issues
- Understanding CLI commands
- Setting up integrations (VS Code, JetBrains, etc.)
- Configuring networking, security, or enterprise features

## Quick Reference

| Task | Read This File |
|------|---------------|
| Create a plugin | `plugins.md` then `plugins-reference.md` |
| Set up MCP server | `mcp.md` |
| Configure hooks | `hooks.md` then `hooks-guide.md` |
| Write a skill | `skills.md` |
| CLI commands | `cli-reference.md` |
| Troubleshoot issues | `troubleshooting.md` |
| General setup | `setup.md` or `quickstart.md` |
| Configuration options | `settings.md` |
| Web-based Claude Code | `claude-code-on-the-web.md` |
| Desktop app | `desktop.md` |
| Chrome extension | `chrome.md` |
| Sandboxing/security | `sandboxing.md` |
| Slack integration | `slack.md` |
| **CLI stream-json control protocol** (live model/effort/mode switching, context-usage breakdown — undocumented, verified empirically) | `howto/stream-json-control-protocol.md` |
| **Agent SDK `billing_error`** (two distinct causes, how to tell them apart) | `howto/agent-sdk-billing-errors.md` |

## Documentation Organization

All documentation is stored as individual markdown files in `references/`. Use the Read tool to access specific documentation:

```
references/
├── overview.md              # Claude Code introduction
├── quickstart.md            # Getting started guide
├── setup.md                 # Installation and setup
├── common-workflows.md      # Common usage patterns
├── claude-code-on-the-web.md # Web-based Claude Code
├── desktop.md               # Desktop application
├── chrome.md                # Chrome extension
├── plugins.md               # Plugin development
├── plugins-reference.md     # Plugin API reference
├── plugin-marketplaces.md   # Plugin marketplaces
├── discover-plugins.md      # Plugin discovery
├── skills.md                # Skill creation
├── mcp.md                   # MCP server integration
├── hooks.md                 # Hooks overview
├── hooks-guide.md           # Hooks implementation guide
├── slash-commands.md        # Slash command reference
├── sub-agents.md            # Subagent usage
├── settings.md              # Configuration reference
├── cli-reference.md         # CLI command reference
├── interactive-mode.md      # Interactive mode guide
├── headless.md              # Headless mode guide
├── output-styles.md         # Output customization
├── statusline.md            # Status line configuration
├── memory.md                # Memory and context management
├── checkpointing.md         # Checkpointing feature
├── sandboxing.md            # Sandboxing and security isolation
├── analytics.md             # Usage analytics
├── costs.md                 # Cost tracking
├── monitoring-usage.md      # Usage monitoring
├── data-usage.md            # Data usage policies
├── security.md              # Security features
├── iam.md                   # IAM integration
├── network-config.md        # Network configuration
├── terminal-config.md       # Terminal configuration
├── model-config.md          # Model configuration
├── llm-gateway.md           # LLM gateway setup
├── amazon-bedrock.md        # AWS Bedrock integration
├── google-vertex-ai.md      # Google Vertex AI integration
├── microsoft-foundry.md     # Microsoft Azure AI Foundry
├── vs-code.md               # VS Code integration
├── jetbrains.md             # JetBrains integration
├── devcontainer.md          # Dev container support
├── github-actions.md        # GitHub Actions integration
├── gitlab-ci-cd.md          # GitLab CI/CD integration
├── slack.md                 # Slack integration
├── third-party-integrations.md  # Other integrations
├── legal-and-compliance.md  # Legal information
├── troubleshooting.md       # Troubleshooting guide
└── claude-setting-sources-isolation.md  # Side-effect-free claude -p from hooks (PM-005)
```

## Workflow

### For Specific Questions

1. Identify the relevant documentation file from the list above
2. Use Read tool to load: `@references/filename.md`
3. Find the answer in the official documentation
4. Apply the solution

**Example:**
```
User: "How do I create a Claude Code plugin?"
→ Read @references/plugins.md
→ Follow the official plugin creation steps
```

### For Broad Topics

When exploring a topic, start with the overview document, then drill into specific files:

- **Extending Claude Code**: Start with `plugins.md`, `skills.md`, or `mcp.md`
- **Configuration**: Start with `settings.md` or `setup.md`
- **Integrations**: Check relevant integration file (vs-code.md, github-actions.md, etc.)
- **Troubleshooting**: Start with `troubleshooting.md`

### For Uncertain Topics

Use Grep tool to search across all documentation:

```bash
pattern: "search term"
path: ~/.claude/skills/working-with-claude-code/references/
```

## Updating Documentation

The skill includes `scripts/update_docs.js` to fetch the latest documentation from code.claude.com.

Run when:
- Documentation seems outdated
- New Claude Code features are released
- Official docs have been updated

```bash
node ~/.claude/skills/working-with-claude-code/scripts/update_docs.js
```

The script:
1. Fetches llms.txt from code.claude.com/docs/
2. Extracts all Claude Code documentation URLs
3. Downloads each page to `references/`
4. Reports success/failures

## Common Patterns

### Plugin Development

Read `plugins.md` for overview, then `plugins-reference.md` for API details.

### MCP Server Setup

Read `mcp.md` for configuration format and examples.

### Hook Configuration

Read `hooks.md` for overview, then `hooks-guide.md` for implementation details.

### Skill Creation

Read `skills.md` for the complete skill authoring guide.

## Manual notes (`references/howto/`)

`references/` (flat files) is entirely auto-fetched from code.claude.com by
`scripts/update_docs.js` and gets overwritten on every run — never hand-edit those files.
`references/howto/` is the exception: hand-written, never touched by the update script, for
empirically-verified or undocumented behavior that has no home in the official docs (mirrors the
same pattern used in the `working-with-github` skill). Add a new `howto/*.md` file there instead
of patching an auto-fetched file, and link it from the Quick Reference table above.

## What This Skill Does NOT Do

- The auto-fetched `references/*.md` files are **documentation access**, not procedural guidance
- For workflows on **how to build** plugins/skills, use the `extending-claude-code` skill (when available)
- Most of this skill is a **reference library**, not a tutorial — `references/howto/` is the
  deliberate, curated exception

## Red Flags

If you find yourself:
- Guessing about configuration file locations → Read `settings.md`
- Speculating about API structures → Read relevant reference doc
- Unsure about hook names → Read `hooks.md`
- Making assumptions about features → Search the docs first

**Always consult the official documentation before guessing.**
Files in this package (152)
  • SKILL.md 8 KB
  • references/2026-w13.md 5 KB
  • references/2026-w14.md 6 KB
  • references/2026-w15.md 5 KB
  • references/2026-w16.md 6 KB
  • references/2026-w17.md 5 KB
  • references/2026-w18.md 5 KB
  • references/2026-w19.md 4 KB
  • references/2026-w20.md 5 KB
  • references/2026-w21.md 4 KB
  • references/2026-w22.md 5 KB
  • references/2026-w23.md 5 KB
  • references/2026-w24.md 4 KB
  • references/2026-w25.md 4 KB
  • references/2026-w26.md 3 KB
  • references/2026-w27.md 5 KB
  • references/2026-w28.md 3 KB
  • references/2026-w29.md 4 KB
  • references/2026-w30.md 5 KB
  • references/2026-w32.md 7 KB
  • references/2026-w33.md 6 KB
  • references/2026-w34.md 7 KB
  • references/2026-w35.md 7 KB
  • references/2026-w36.md 7 KB
  • references/2026-w37.md 5 KB
  • references/accessibility.md 14 KB
  • references/admin-setup.md 29 KB
  • references/admin.md 37 KB
  • references/advisor.md 18 KB
  • references/agent-loop.md 41 KB
  • references/agent-teams.md 42 KB
  • references/agent-view.md 144 KB
  • references/agents.md 9 KB
  • references/amazon-bedrock.md 46 KB
  • references/analytics.md 12 KB
  • references/anthropic-marketplaces.md 9 KB
  • references/api.md 39 KB
  • references/artifacts.md 42 KB
  • references/authentication.md 34 KB
  • references/auto-mode-classifier-billing.md 7 KB
  • references/auto-mode-config.md 32 KB
  • references/best-practices.md 37 KB
  • references/champion-kit.md 16 KB
  • references/channels-reference.md 45 KB
  • references/channels.md 23 KB
  • references/checkpointing.md 9 KB
  • references/chrome.md 24 KB
  • references/claude-apps-gateway-config.md 137 KB
  • references/claude-apps-gateway-deploy.md 75 KB
  • references/claude-apps-gateway-on-aws.md 51 KB
  • references/claude-apps-gateway-on-gcp.md 22 KB
  • references/claude-apps-gateway-spend-limits.md 17 KB
  • references/claude-apps-gateway.md 61 KB
  • references/claude-code-features.md 21 KB
  • references/claude-code-on-the-web.md 46 KB
  • references/claude-directory.md 31 KB
  • references/claude-platform-on-aws.md 12 KB
  • references/claude-projects.md 61 KB
  • references/claude-security.md 16 KB
  • references/claude-setting-sources-isolation.md 9 KB
  • references/claude-tag.md 1 KB
  • references/claude_code_docs_map.md 192 KB
  • references/cli-hints.md 7 KB
  • references/cli-reference.md 63 KB
  • references/cloud-environments.md 65 KB
  • references/code-intelligence.md 12 KB
  • references/code-review-costs.md 6 KB
  • references/code-review-customize.md 16 KB
  • references/code-review-local.md 14 KB
  • references/code-review-pull-requests.md 16 KB
  • references/code-review-setup.md 14 KB
  • references/code-review-troubleshooting.md 11 KB
  • references/code-review.md 11 KB
  • references/commands.md 58 KB
  • references/common-workflows.md 18 KB
  • references/communications-kit.md 21 KB
  • references/components.md 40 KB
  • references/computer-use.md 12 KB
  • references/configuration.md 18 KB
  • references/context-window.md 9 KB
  • references/corporate-launcher.md 15 KB
  • references/cost-tracking.md 27 KB
  • references/costs.md 46 KB
  • references/create-marketplace.md 16 KB
  • references/create.md 25 KB
  • references/cross-session-messaging.md 36 KB
  • references/custom-tools.md 37 KB
  • references/data-usage.md 19 KB
  • references/debug-your-config.md 18 KB
  • references/deep-links.md 14 KB
  • references/dependencies.md 17 KB
  • references/desktop-changelog.md 7 KB
  • references/desktop-ios-simulator.md 12 KB
  • references/desktop-linux.md 13 KB
  • references/desktop-quickstart.md 12 KB
  • references/desktop-scheduled-tasks.md 16 KB
  • references/desktop-wsl.md 4 KB
  • references/desktop.md 198 KB
  • references/devcontainer.md 18 KB
  • references/discover-plugins.md 38 KB
  • references/env-vars.md 181 KB
  • references/errors.md 571 KB
  • references/events.md 36 KB
  • references/examples.md 2 KB
  • references/fast-mode.md 21 KB
  • references/feature-availability.md 25 KB
  • references/features-overview.md 29 KB
  • references/file-checkpointing.md 27 KB
  • references/fullscreen.md 31 KB
  • references/gallery.md 20 KB
  • references/gateways.md 10 KB
  • references/github-actions-cloud-providers.md 17 KB
  • references/github-actions.md 29 KB
  • references/github-enterprise-server.md 20 KB
  • references/gitlab-ci-cd.md 18 KB
  • references/glossary.md 30 KB
  • references/goal.md 15 KB
  • references/google-vertex-ai.md 22 KB
  • references/headless.md 37 KB
  • references/hipaa-setup.md 22 KB
  • references/hooks-guide.md 64 KB
  • references/hooks.md 276 KB
  • references/host-marketplace.md 39 KB
  • references/hosting.md 24 KB
  • references/how-claude-code-works.md 20 KB
  • references/iam.md 14 KB
  • references/index.md 15 KB
  • references/install.md 32 KB
  • references/interactive-mode.md 77 KB
  • references/interface.md 51 KB
  • references/jetbrains.md 12 KB
  • references/keybindings.md 40 KB
  • references/large-codebases.md 35 KB
  • references/legal-and-compliance.md 7 KB
  • references/llm-gateway-connect.md 46 KB
  • references/llm-gateway-protocol.md 49 KB
  • references/llm-gateway-rollout.md 30 KB
  • references/llm-gateway.md 8 KB
  • references/loading.md 43 KB
  • references/managed-mcp.md 46 KB
  • references/managed-settings.md 62 KB
  • references/manifest-reference.md 43 KB
  • references/marketplace-reference.md 47 KB
  • references/mcp-quickstart.md 25 KB
  • references/mcp.md 147 KB
  • references/measure.md 13 KB
  • references/memory.md 54 KB
  • references/microsoft-foundry.md 10 KB
  • references/migration-guide.md 7 KB
  • references/mobile.md 9 KB
  • references/observability.md 18 KB
  • references/howto/agent-sdk-billing-errors.md 3 KB

Omitted from the package: 78 (too large or executable); available in the repository.

Versions

RepositoryScoreLicence
This page · joeblackwaslike/agent-skills100MIT
clarit-ai/plexium100Apache-2.0

Database snapshot: 13.11.2026 · package version 26fe88f9d901 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100working-with-codex
    Use when working with Codex CLI, plugins, skills, hooks, configuration, or any Codex feature - provides comprehensive official documentation for all aspects of the OpenAI Codex CLI
  • 100working-with-opencode
    Use when working with OpenCode CLI, plugins, skills, hooks, configuration, or any OpenCode feature - provides comprehensive official documentation for all aspects of the OpenCode AI coding assistant
  • 86claude-code-docs
    Use when answering questions about current Claude Code behavior, configuration, CLI features, hooks, skills, plugins, sessions, compaction, permissions, or other Claude Code-specific interfaces from official documentation.
  • 100claude-code-docs
    Answer questions about Claude Code (features, hooks, plugins, skills, MCP, Agent SDK, settings, CLI) from the official docs. Uses the ask CLI to resolve a version-pinned local mirror and csp for semantic search, falling back to grep and WebFetch. Use when the user asks how…
  • 100agents-docs
    Use for current official documentation about Codex, Codex CLI, or Claude Code behavior, configuration, prompting, skills, permissions, tools, surfaces, capabilities, troubleshooting, hooks, app-server, or hook trust. Consult the relevant official source before answering.
  • 100claude-code-cli
    Use when working with the Claude Code CLI (`claude`) — headless and interactive modes, flags, agents, plugins, MCP servers, hooks, settings, sessions, and the local custom ecosystem (forge, bob, alf, pa, wiki, agent-teams). Covers Claude Code 2.1.x. Refresh of the upstream…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.