Highlight differences from official Anthropic docs:
- Visual tutorials with diagrams vs reference docs
- Production-ready templates vs basic snippets
- Progressive learning path vs feature-organized
- Guided roadmap with time estimates
- Make agent self-contained by embedding rules (no external file reference)
- Remove redundant sections and verbose examples
- Consolidate evaluation categories into concise checklist
- Simplify output format template
- Replace simple Stop-only context-usage hook with hook pair pattern
- Add UserPromptSubmit + Stop hook combination for tracking delta
- Include both char-estimation and tiktoken versions as separate files
- Show how to use session_id for isolated state tracking
The hook was converting total_chars to string before calculating tokens,
resulting in ~0 tokens reported. Fixed to calculate directly from char count.
- Remove unused estimate_tokens() function
- Calculate tokens as total_chars // 4 directly
- Archive fix-context-usage-hook change
- Add Managing Skills section (viewing, testing, updating, removing)
- Expand Troubleshooting with debugging tips for skipped skills, YAML errors, permissions
- Add Version History best practice section with example
- Enhance allowed-tools documentation with security use cases
- Add Multi-File Skill Example showing complex skill structure
- Add version history to code-review SKILL.md example
Based on: https://code.claude.com/docs/en/skills
- Update README with all official features:
- Built-in subagents (General-Purpose, Plan, Explore)
- /agents command for interactive management
- CLI-based configuration with --agents flag
- Resumable agents with agentId
- File locations and priority order
- Configuration fields (name, description, tools, model, permissionMode, skills)
- Chaining subagents for multi-agent workflows
- Update existing subagent examples to new format:
- Add model field
- Update YAML frontmatter format
- Add proactive usage hints in descriptions
- Add new example subagents:
- debugger.md - Root cause analysis specialist
- data-scientist.md - SQL/BigQuery data analysis expert
Based on: https://code.claude.com/docs/en/sub-agents
Add Example 6 showing how to create a hook that reports context/token
usage after each Claude response:
- Python script reads transcript_path to access conversation history
- Estimates tokens using ~4 chars/token heuristic
- Outputs one-line report: "Context: ~45k/200k tokens (77% remaining)"
- Documents both Stop and UserPromptSubmit hook configurations
- Explains limitations (estimate vs exact /context command)
- Added blog-posts/ to .gitignore to prevent tracking of blog-related files.
- Included rule to ignore all EPUB files in the root directory for cleaner repository management.
- Migrate SKILL.md files to new format (lowercase names, consolidated descriptions)
- Remove deprecated fields: version, tags, when_to_use
- Add Creating Custom Skills section with format requirements
- Add Troubleshooting Guide and team sharing sections
- Enhance Best Practices with specific examples
- Remove Pre-built Skills section (no longer in official docs)
- Introduced a new script to build an EPUB from markdown files, enhancing documentation accessibility.
- Added a GitHub Actions workflow for automated EPUB builds on version tag pushes.
- Created the initial EPUB file 'claude-howto-guide.epub' for distribution.
This update streamlines the process of creating and releasing the Claude How-To guide in EPUB format.
- Add Medium blog post link about slash commands to README files
- Convert claude-howto-logo.svg to PNG format (1024x256)
- Replace old claude-ai-icon.webp with new logo
- Update .gitignore to exclude blog-posts directory
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add claude-howto-logo.svg to 12 README files across the project
- Use appropriate relative paths for different directory levels
- Include new memory guide screenshots
- Add personal CLAUDE.md configuration
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
Created a professional SVG logo for the project featuring:
- Modern gradient design with code brackets symbol
- Book/guide icon representing learning and documentation
- "Claude How To" branding with subtitle
- Decorative elements and professional color scheme
Added logo to all major documentation files:
- README.md
- INDEX.md
- QUICK_REFERENCE.md
- claude_concepts_guide.md
The logo provides consistent branding across the project and improves visual appeal on GitHub and other markdown viewers.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Added three new major feature categories with complete documentation and examples:
## New Features
### 07-hooks/
- Event-driven automation with 6 example hook scripts
- Pre/post tool hooks, session hooks, and git hooks
- Auto-formatting, security scanning, test automation
- Complete documentation with best practices
### 08-checkpoints/
- Conversation state snapshots and rewind capability
- Safe experimentation and approach comparison
- Real-world examples: DB migration, performance optimization, UI iteration
- Checkpoint management commands and workflows
### 09-advanced-features/
- Planning Mode: detailed implementation plans before coding
- Extended Thinking: deep reasoning for complex problems
- Background Tasks: long-running operations without blocking
- Permission Modes: unrestricted, confirm, read-only, custom
- Headless Mode: CI/CD integration and automation
- Session Management: multiple work sessions
- Interactive Features: keyboard shortcuts, command history
- 10+ configuration examples for different scenarios
## Documentation Updates
- README.md: Added sections for all new features with examples
- INDEX.md: Updated with new categories, file listings, and search keywords
- QUICK_REFERENCE.md: Added quick reference for new features
- claude_concepts_guide.md: Comprehensive guide sections for new concepts
## Statistics
- Total files: 90+ (up from 71)
- Categories: 9 (up from 6)
- New hook scripts: 6
- New documentation files: 10+
- Configuration examples: 10+ scenarios
All examples are production-ready and follow Claude Code best practices.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Added comprehensive examples for Claude Code features including slash commands, subagents, memory, MCP protocol, skills, and plugins with documentation and quick reference guides.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>