diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..0fefdb5 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,5 @@ +# Project Instructions + +## MANDATORY: Keep README in sync + +When adding, removing, or renaming any file in this repository, **update README.md** to reflect the change. The README serves as the index of all repository contents — every document must be listed there with a short description. Also update the "Last updated" date in README.md to the current date. diff --git a/README.md b/README.md index 99b5ce3..c86585f 100644 --- a/README.md +++ b/README.md @@ -1,40 +1,14 @@ # Claude Code Facts -A collection of interesting and useful facts, tips, and tools for working with Claude and Claude Code — including plugins, MCP servers, and practical usage patterns. +> Last updated: 2026-03-23 -## MCP Servers +A collection of interesting and useful facts, tips, tools, and guides for working with Claude and Claude Code. -MCP (Model Context Protocol) servers are external processes that provide tools to Claude Code via a standardized protocol. They run alongside your session and extend Claude's capabilities. +## Contents -### Context7 +### [Claude Code Tools & Extensions](claude-code-tools.md) -Up-to-date documentation and code examples for any library, available directly in your Claude Code session. - -- **Website:** -- **Setup:** - - ```bash - claude mcp add --scope user --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: " - ``` - -- **Note:** API key can be created for free after signing in at [context7.com](https://context7.com/) - -## Skills (Slash Commands) - -Skills are a different extension mechanism from MCPs. They are prompt-based extensions invoked via `/skill-name` commands directly within Claude Code — no external server required. - -### AST Index - -Fast code search skill for Claude Code — find classes, symbols, usages, implementations, and more across large codebases using AST parsing. - -- **Repository:** -- **Usage:** Invoke with `/ast-index` or related commands like "find class", "search for symbol", etc. - -## Guides - -### [Everything Claude Code (ECC) — Setup Guide](ecc-setup-guide.md) - -Step-by-step instructions for setting up [Everything Claude Code](https://github.com/affaan-m/everything-claude-code) on a new machine — a comprehensive collection of skills, rules, agents, and hooks for Claude Code. +MCP servers, skills, and plugins that extend Claude Code — including Context7 (library docs) and AST Index (fast code search). ### [CI/CD for Python Apps on Gitea](gitea-python-ci-cd.md) diff --git a/claude-code-tools.md b/claude-code-tools.md new file mode 100644 index 0000000..32da995 --- /dev/null +++ b/claude-code-tools.md @@ -0,0 +1,40 @@ +# Claude Code Tools & Extensions + +Useful tools, plugins, and extensions for Claude Code. + +## MCP Servers + +MCP (Model Context Protocol) servers are external processes that provide tools to Claude Code via a standardized protocol. They run alongside your session and extend Claude's capabilities. + +### Context7 + +Up-to-date documentation and code examples for any library, available directly in your Claude Code session. + +- **Website:** +- **Setup:** + + ```bash + claude mcp add --scope user --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: " + ``` + +- **Note:** API key can be created for free after signing in at [context7.com](https://context7.com/) + +## Skills (Slash Commands) + +Skills are a different extension mechanism from MCPs. They are prompt-based extensions invoked via `/skill-name` commands directly within Claude Code — no external server required. + +### AST Index + +Fast code search skill for Claude Code — find classes, symbols, usages, implementations, and more across large codebases using AST parsing. + +- **Repository:** +- **Usage:** Invoke with `/ast-index` or related commands like "find class", "search for symbol", etc. + +## Toolkits + +### Everything Claude Code (ECC) + +A comprehensive collection of skills, rules, agents, and hooks for Claude Code. + +- **Repository:** +- **Setup guide:** [ecc-setup-guide.md](ecc-setup-guide.md)