Inkdown
Start writing

Claude-Code

62 filesยท4 subfolders

Shared Workspace

Claude-Code
codex

09-skills-plugins

Shared from "Claude-Code" on Inkdown

Skills & Plugins Architecture

Overview

Skills and Plugins extend Claude Code's capabilities. Skills are user-defined prompts and workflows. Plugins are code extensions that add tools and commands.

Plain text
0000_start_here_index_and_recommended_reading_order.md
0100_project_overview_tech_stack_runtime_modes_and_folder_map.md
0200_startup_flow_entry_points_and_cold_start_sequence.md
0300_codebase_modules_layers_state_models_and_schemas.md
0400_system_architecture_and_design_rationale.md
0500_interactive_repl_request_flow_end_to_end.md
0600_headless_sdk_and_print_mode_request_flow_end_to_end.md
0700_mcp_integration_connection_and_tool_call_flow.md
0800_external_services_sdks_storage_and_local_dependencies.md
0900_environment_variables_settings_feature_flags_and_failure_modes.md
1000_non_obvious_patterns_gotchas_and_debugging_traps.md
1100_full_codebase_file_inventory_grouped_by_directory.md
kimi
00-overview.md
01-entrypoints.md
02-state-management.md
03-query-system.md
04-tools-system.md
05-tasks-system.md
06-ui-components.md
07-bridge-remote.md
08-services.md
09-skills-plugins.md
10-commands.md
11-testing-architecture.md
12-permission-system.md
13-build-system.md
14-ink-internals.md
15-git-internals.md
16-context-compaction.md
17-vim-mode.md
18-mailbox-notifications.md
19-session-persistence.md
20-hooks-system.md
21-error-recovery.md
README.md
qwen
00-overview.md
01-entry-points.md
02-query-engine.md
03-tools-and-tasks.md
04-commands-and-skills.md
05-state-management.md
06-ink-rendering.md
07-bridge-remote.md
08-mcp-services.md
09-services-overview.md
10-multi-agent.md
11-system-prompt-constants.md
12-tool-interface.md
13-memory-system.md
14-buddy-companion.md
15-keybindings.md
16-stop-hooks.md
17-vim-mode.md
18-upstreamproxy.md
19-cost-tracking-history.md
20-contexts-styles-onboarding.md
21-hooks.md
22-screens.md
tweets-explain
claude-code-memory-analysis.md
compact
memory-system
agentic-architecture

Skills

What is a Skill?

A skill is a reusable prompt template with optional parameter extraction.

TypeScript
Skill File Format
Markdown
Parameter Extraction
Markdown

Input: "Please review PR #123" โ†’ Extracts: { pr_number: 123 }


Skills System Files

FilePurpose
skills/loadSkillsDir.tsLoad and parse skills
skills/bundledSkills.tsBuilt-in skills registry
skills/bundled/Bundled skill implementations
skills/mcpSkillBuilders.tsConvert MCP to skills
commands/skills/index.ts/skills command
Loading Skills
TypeScript
Skill Execution
TypeScript

Plugins

What is a Plugin?

A plugin is a code package that extends Claude Code with:

  • Custom tools
  • Custom commands
  • Custom UI components
  • Event hooks
Plugin Structure
Plain text
Plugin Manifest
JSON

Plugin System Files

FilePurpose
utils/plugins/pluginLoader.tsLoad plugins from disk
utils/plugins/installedPluginsManager.tsManage installed plugins
utils/plugins/builtinPlugins.tsBuilt-in plugin registry
services/plugins/Plugin marketplace integration
plugins/bundled/Bundled plugin implementations
Plugin Loading
TypeScript
Plugin Context
TypeScript

Built-in vs Bundled vs External

Built-in Plugins
TypeScript

Bundled with the binary, always available.

User-Installed Plugins
Bash

Stored in ~/.claude/plugins/.

Marketplace Plugins
TypeScript

MCP vs Plugins

Migration Path
Plain text
Using MCP in Skills
TypeScript

Skill Discovery

Auto-Discovery
TypeScript
CLAUDE.md Files

Special file that defines project context:

Markdown

Loaded automatically as context.


Plugin Lifecycle

Plain text

Best Practices

Skill Writing
Markdown

Check this code.

Plain text

Key Concepts

1. Skills = Declarative

Markdown + frontmatter. Easy to write, version control, share.

2. Plugins = Imperative

JavaScript/TypeScript code. Powerful, but more complex.

3. MCP = Standard

Protocol-based. Language-agnostic, sandboxed, future-proof.

4. Discovery is Automatic

Skills found in standard locations. No registration needed.

5. Permissions Matter

Plugins declare permissions. Users review before install.


Related Documentation

  • Tools System - How plugin tools work
  • Commands - How plugin commands work
  • Services - MCP services