@shaykec/plugin

Claude Code plugin for Socrates -- defines skills (slash commands), hooks, and session tracking that integrate the teaching platform into Claude Code.

npm install @shaykec/plugin

Skills

| Skill | File | Description | |-------|------|-------------| | /teach | skills/teach/SKILL.md | Socratic teaching -- start/resume guided lessons | | /teach:ask | skills/ask/SKILL.md | Q&A from installed module content | | /teach:stats | skills/stats/SKILL.md | Gamification dashboard -- XP, belt, progress | | /teach:level-up | skills/level-up/SKILL.md | Belt roadmap and personalized recommendations | | /teach:canvas | skills/canvas/SKILL.md | Open the visual canvas in the browser | | /teach:author | skills/author/SKILL.md | Guided module authoring (content, walkthroughs, quizzes) | | /teach:author-pack | skills/author-pack/SKILL.md | Guided pack authoring (multi-module collections) |

Plugin Configuration

Defined in .claude-plugin/plugin.json. Skills are registered with Claude Code and become available as slash commands.

How Skills Work

Each skill is a markdown file (SKILL.md) containing instructions for the AI. When a user types a slash command, Claude Code reads the corresponding SKILL.md and follows its instructions. Skills can:

• Read and write files (progress tracking, module content)
• Execute bash commands (validation, bridge communication)
• Send HTTP requests to the bridge server (visual commands)
• Guide multi-step interactions (Socratic dialogue, authoring workflows)

Hooks

Shell hooks in .claude-plugin/hooks/ track Claude Code lifecycle events:

• track-usage.sh -- Records session usage for streak tracking

Note: Canvas interaction events (quiz completions, playground runs) flow through the bridge server, not through shell hooks.

See the root README for full documentation.