claude-code-skill-power/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is a Claude Code Skills repository containing two main components:

1. FileSystem MCP Server (filesystem-mcp-server/) - A Model Context Protocol server implementation in TypeScript
2. Claude Skills (.claude/skills/) - 16 modular skills that extend Claude's capabilities

Build Commands

All commands run from filesystem-mcp-server/ directory:

# Build the TypeScript MCP server
npm run build

# Development mode with hot reload
npm run dev

# Start the server (after build)
npm start

# Clean build artifacts
npm run clean

Environment Variables:

• TRANSPORT - Transport mode (stdio or http, default: http)
• PORT - HTTP port (default: 3000)

Architecture

MCP Server (filesystem-mcp-server/)

• Transport: Dual support (stdio for local, HTTP for remote)
• Entry point: src/index.ts - handles transport selection
• Tools: Modular pattern in src/tools/ - each tool in its own file
• Validation: Zod schemas for all tool inputs
• Type safety: Strict TypeScript with src/types.ts and src/constants.ts

Skills (.claude/skills/)

Each skill follows a standard structure:

• SKILL.md - Main documentation with YAML frontmatter (name, description)
• Optional: scripts/, references/, assets/ folders
• Most skills reference Python libraries (pypdf, reportlab, python-pptx, openpyxl, etc.)

Key Skills

• mcp-builder - Guides creating MCP servers with TypeScript/Python SDKs
• skill-creator - Guides creating new skills (6-step process)

Important Notes

• No package.json at root - each component is separate
• MCP server uses ES modules ("type": "module")
• No existing Cursor/Copilot rules files