Skills Guide

Écosystème Claude Code

Guide complet de l'outil CLI Claude Code, de l'extensibilité (agents, compétences, styles de sortie) et de l'architecture CLAUDE.md pour la configuration et l'optimisation.

Spar Skills Guide Bot
DeveloppementIntermédiaire
10018/08/2026
Claude Code
#claude-code#cli#mcp-servers#agents#skills

Recommandé pour

Revue de codeClaude CodeDéveloppeur backendDéveloppeur frontendDéveloppeur fullstackRefactoring

name: claude-ecosystem description: "Claude Code ecosystem expertise. Modules: CLI tool (setup, slash commands, MCP servers, hooks, plugins, CI/CD), extensibility (agents, skills, output styles creation), CLAUDE.md (project instructions, optimization). Actions: configure, troubleshoot, create, deploy, integrate, optimize Claude Code. Keywords: Claude Code, Anthropic, CLI tool, slash command, MCP server, Agent Skill, hook, plugin, CI/CD, enterprise, CLAUDE.md, agentic coding, agent, skill, output-style, SKILL.md, subagent, Task tool, project instructions, token optimization. Use when: learning Claude Code features, configuring settings, creating skills/agents/hooks, setting up MCP servers, troubleshooting issues, CI/CD integration, initializing or optimizing CLAUDE.md files."

Claude Ecosystem

Comprehensive guide for Claude Code CLI tool, extensibility (agents/skills/output styles), and CLAUDE.md architecture.

Module Selection

| Need | Module | Reference | |------|--------|-----------| | Setup/Configuration | CLI | references/getting-started.md, references/configuration.md | | Slash Commands | CLI | references/slash-commands.md | | MCP Servers | CLI | references/mcp-integration.md | | Hooks & Plugins | CLI | references/hooks-and-plugins.md | | Create Agents | Extensibility | references/agent-development.md | | Create Skills | Extensibility | references/skill-development.md | | Output Styles | Extensibility | references/skill-development.md | | Init CLAUDE.md | Architecture | references/initialization-workflow.md | | Optimize CLAUDE.md | Architecture | references/optimization-patterns.md | | Enterprise/CI-CD | CLI | references/enterprise-features.md, references/cicd-integration.md | | Troubleshooting | CLI | references/troubleshooting.md |

Quick Reference

Extension Types

| Type | Invocation | Purpose | Location | |------|------------|---------|----------| | Agents | Task tool | Specialized sub-processes | .claude/agents/ | | Skills | Model-invoked | Domain knowledge | .claude/skills/{name}/ | | Output Styles | /output-style | Modify main agent | .claude/output-styles/ |

Model Selection (Agents)

| Model | Use When | Target Time | |-------|----------|-------------| | haiku | Fast tasks, exploration | < 3s | | sonnet | Balanced, most use cases | < 10s | | opus | Complex reasoning | < 30s |

CLAUDE.md Token Budget

| Complexity | Target Tokens | |-----------|---------------| | Simple | 100-200 | | Medium | 200-400 | | Complex | 400-800 | | Maximum | 1000 |

Extensibility Principles

Core Truths

| Truth | Meaning | |-------|---------| | Expertise Transfer | Make Claude think like expert, not follow steps | | Flow, Not Friction | Produce output, not intermediate work | | Voice Matches Domain | Sound like practitioner, not documentation | | Focused Beats Comprehensive | Constrain ruthlessly |

Decision Heuristics

| Rule | Guidance | |------|----------| | 3-File Rule | 3+ files → agent. Enhances YOUR work → skill. | | Delegation Test | Runs independently? Agent. Guides you? Skill. | | Activation Breadth | Trigger on 80% of relevant requests | | Tool Constraint | Start with 2-3 essential tools |

Activation Keywords

The description field is your activation gate. Include:

  1. Task verbs: create, build, debug, fix, deploy
  2. Problem descriptions: slow, broken, failing
  3. Artifact types: component, API, database
  4. Casual synonyms: "make it faster" → optimize

Common Workflows

Create Agent

---
name: agent-name
description: "Use when [use case]. PROACTIVELY for [triggers].\n\nExamples:\n<example>\nContext: [situation]\nuser: [request]\nassistant: [response]\n</example>"
tools: Grep, Glob, Read, Bash
model: haiku
---

# Agent Name

Mission statement.

## Strategy
[Approach]

## Does NOT Do
- [boundary] (use X instead)

Create Skill

---
name: skill-name
description: "[Core purpose]. [Technologies]. Capabilities: [list].
  Actions: [verbs]. Keywords: [triggers]. Use when: [scenarios]."
allowed-tools: Read, Grep, Glob
---

# Skill Name

## Patterns

### [Pattern Name]
**When you see:** [Observable trigger]
**This indicates:** [Expert insight]
**Therefore:** [Action]
**Watch out:** [Pitfall]

Initialize CLAUDE.md

  1. Analyze codebase (language, framework, structure)
  2. Extract code style, commands, patterns
  3. Generate with template, customize
  4. Validate commands, check token count
  5. Target <400 lines, prefer <250

Detailed: references/initialization-workflow.md

Optimize CLAUDE.md

  1. Evaluate token efficiency
  2. Find redundancy, outdated info
  3. Apply token reduction techniques
  4. Target 40%+ reduction
  5. Verify critical info retained

Detailed: references/optimization-patterns.md

Anti-Patterns

| Pattern | Problem | Fix | |---------|---------|-----| | Kitchen Sink Agent | 10+ tools, handles "everything" | Constrain to 3-5 tools | | Echo Skill | Restates docs without insight | Add expert layer | | Invisible Trigger | Description uses only formal terms | Include user language | | Procedure Manual | Step 1, 2, 3... | Teach patterns, not steps | | Over-Documentation | CLAUDE.md > 400 lines | Document project-specific only |

Quality Signals

Good Signs

  • Frontmatter reads like "when to use" guide
  • First 10 lines provide actionable guidance
  • Expert would nod "yes, that's how I think"
  • Explicit constraints on what it does NOT handle

Warning Signs

  • 50% reference tables or field definitions

  • No mention of "when NOT to use"
  • Generic language for any domain
  • Body exceeds 600 lines

References

CLI Tool

  • references/getting-started.md - Installation, setup, auth
  • references/slash-commands.md - Complete command catalog
  • references/mcp-integration.md - MCP server configuration
  • references/hooks-and-plugins.md - Hook types, plugin structure
  • references/configuration.md - Settings hierarchy
  • references/enterprise-features.md - IAM, SSO, sandboxing
  • references/cicd-integration.md - GitHub Actions, GitLab CI
  • references/ide-integration.md - VS Code, JetBrains
  • references/advanced-features.md - Extended thinking, caching
  • references/troubleshooting.md - Common issues
  • references/api-reference.md - Admin, Messages, Skills APIs
  • references/best-practices.md - Project organization, security
  • references/agent-skills.md - Creating skills via CLI

Extensibility

  • references/agent-development.md - Full YAML structure, system prompts
  • references/skill-development.md - Structure, triggers, hooks

CLAUDE.md

  • references/initialization-workflow.md - Creating new CLAUDE.md
  • references/optimization-patterns.md - Token reduction techniques
  • references/integration-strategies.md - Global config, MCP tools
  • references/output-templates.md - Standard output formats

Related Skills

IMPORTANT: When creating/editing prompts, use prompt-architect skill.

Skill("prompt-architect") → Create/enhance skill/agent prompt content

Documentation:

  • llms.txt: https://context7.com/websites/claude_en_claude-code/llms.txt?tokens=10000
  • Main docs: https://docs.claude.com/en/docs/claude-code/
  • GitHub: https://github.com/anthropics/claude-code
Skills similaires

Expert Next.js App Router

Developpement

Un skill qui transforme Claude en expert Next.js App Router.

Claude CodeCursoradvanced
890
234
3,463
Admin

Générateur de README

Developpement

Crée des README.md professionnels et complets pour vos projets.

claudeCursorWindsurfbeginner
259
72
1,362
Admin

Rédacteur de Documentation API

Developpement

Génère de la documentation API complète au format OpenAPI/Swagger.

claudeCursorWindsurfintermediate
156
44
1,247
Admin