- Add Example 5 (Code Refactoring Skill) to 03-skills/README.md
with directory structure, SKILL.md snippet, and usage example
- Add refactor skill entry to CATALOG.md skills table
Create CATALOG.md containing quick reference for all Claude Code features:
- Slash commands (built-in and custom)
- Sub-agents with capabilities and tools
- Skills with auto-invocation triggers
- Plugins with component breakdowns
- MCP servers for external integrations
- Hooks for event-driven automation
Each feature includes one-command installation instructions.
Update README.md to link to the new catalog.
Add comprehensive Agent Skill for systematic code refactoring with:
- Main SKILL.md with 6-phase workflow (research, test coverage, smell
identification, planning, implementation, review)
- Code smells reference catalog (22+ smells with examples)
- Refactoring techniques catalog (25+ techniques with mechanics)
- Refactoring plan template for tracking progress
- Python scripts for complexity analysis and smell detection
- User consultation points at each decision phase
- Safety guidelines emphasizing tests and small steps
- Update all main markdown files (INDEX.md, LEARNING-ROADMAP.md, QUICK_REFERENCE.md, CONTRIBUTING.md, claude_concepts_guide.md, resources.md) with new responsive picture element
- Add logo to all subdirectory README files in feature folders (01-10) and plugins
- Replace old markdown image syntax with HTML picture element for dark/light mode adaptation
- Logo automatically displays dark mode version when system prefers dark mode
- Maintain correct relative paths for all nesting levels (../, ../../, etc.)
- Update README.md with new logo syntax
All markdown files now use the new V2.0 starburst logo design with professional dark/light mode support.
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)
Luong NGUYEN