How denfry/claude-skills works
claude-skills is a collection of Claude agent skills; its featured token-efficiency skill shapes responses across coding, writing, research, and chat. The main path is a user request handled under the skill’s guidance, with optional Claude Code hooks reinforcing the guidance, flagging inefficient tool use, and reporting session metrics. The repository also provides worked examples and an A/B evaluation harness. Hook implementation details are sampled; relationships for the unsampled skill content and examples are limited to README documentation.
Main entry points: install.py Hook installer · efficiency_core.py Prompt reinforcement · session_report.py Session report · _state.py Session state
Components 14
Skill guidance
- Response guidance
skills/token-efficiency/SKILL.md - Core contract
skills/token-efficiency/CORE.md - Short contract
skills/token-efficiency/CORE_SHORT.md - Worked examples
skills/token-efficiency/references/examples.md
Claude Code hooks
- Hook installer
skills/token-efficiency/hooks/install.py - Context budget
skills/token-efficiency/hooks/context_budget.py - Prompt reinforcement
skills/token-efficiency/hooks/efficiency_core.py - Trajectory guard
skills/token-efficiency/hooks/trajectory_guard.py - Session report
skills/token-efficiency/hooks/session_report.py - Session state
skills/token-efficiency/hooks/_state.py
Evaluation resources
- A/B eval harness
skills/token-efficiency/evals/measure.py - Eval tasks
skills/token-efficiency/evals/evals.json
Other components
- User
- Claude surface
Connections 15
- User → Claude surface: submits request
README.md - Response guidance → Claude surface: guides responses
README.md - Claude surface → User: returns response
README.md - Claude surface → Worked examples: consults examples
README.md - Hook installer → Context budget: registers hook
skills/token-efficiency/hooks/install.py - Hook installer → Prompt reinforcement: registers hook
skills/token-efficiency/hooks/install.py - Hook installer → Trajectory guard: registers hook
skills/token-efficiency/hooks/install.py - Hook installer → Session report: registers hook
skills/token-efficiency/hooks/install.py - Prompt reinforcement → Core contract: reads contract
skills/token-efficiency/hooks/efficiency_core.py - Prompt reinforcement → Short contract: reads contract
skills/token-efficiency/hooks/efficiency_core.py - Context budget → Session state: reads event
skills/token-efficiency/hooks/context_budget.py - Trajectory guard → Session state: loads and saves
skills/token-efficiency/hooks/trajectory_guard.py - Session report → Session state: loads and saves
skills/token-efficiency/hooks/session_report.py - Session report → A/B eval harness: writes metrics for
skills/token-efficiency/hooks/session_report.py - A/B eval harness → Eval tasks: loads tasks
skills/token-efficiency/evals/measure.py