Add using-skill-set plugin for automatic session initialization

[ether-moon]

Summary

Add new using-skill-set plugin that automatically activates skill-set awareness at the start of every Claude Code session. This is a required core plugin that ensures agents consistently check for and use available skill-set plugins before starting any task.

Changes

New Plugin: using-skill-set (Core)

Plugin Structure:

using-skill-set/
├── .claude-plugin/
│   └── plugin.json          # Plugin metadata with inline hooks
├── scripts/
│   └── session-start.sh     # Auto-detects installed plugins
└── SKILL.md                 # Main skill file with {{INSTALLED_PLUGINS}} template

Key Features:

• Auto-detects installed skill-set plugins from ~/.claude/plugins/
• Enforces mandatory workflow to check for relevant plugins before tasks
• Provides plugin descriptions and use case guidelines
• Uses SessionStart hook (startup|resume|clear|compact)
• Prevents rationalization and workflow bypassing

How It Works

1. Session start trigger: Hook executes automatically on session events
2. Plugin scanning: Script checks for 5 skill-set plugins in ~/.claude/plugins/
3. Dynamic injection: Replaces {{INSTALLED_PLUGINS}} in SKILL.md with detected plugins
4. Agent awareness: Full skill content provided to agent's context

Documentation Updates

• README.md: Added using-skill-set as required core plugin
• marketplace.json: Added using-skill-set as first plugin in the list
• Emphasized installation order: core plugin first, then feature plugins
• Explained that using-skill-set enables proper recognition of other plugins

Installation

/plugin install using-skill-set

Once installed, the plugin automatically activates on every session start.

Benefits

• Prevents workflow bypassing: Agents can't skip mandatory steps
• Improves consistency: Same workflows across all sessions
• Reduces errors: Proven patterns automatically applied
• Foundation for other plugins: Makes all other skill-set plugins work effectively

Summary by CodeRabbit

• New Features

  • Added the "using-skill-set" Core Plugin that establishes mandatory workflows for discovering and utilizing skill-set plugins during conversations.

• Documentation

  • Added installation instructions and usage guidelines for the new Core Plugin in the README.
  • Included comprehensive documentation on best practices and required procedures for leveraging available skill-set plugins in your workflow.

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

This PR introduces a new "using-skill-set" core plugin that establishes mandatory workflows for discovering and utilizing skill-set plugins. The addition includes plugin registration in the marketplace, manifest configuration with session-start hooks, documentation of usage procedures, and an automated script for detecting installed plugins and updating reference documentation at session initialization.

Changes

Cohort / File(s)	Summary
Plugin Registration \.claude-plugin/marketplace\.json, using-skill-set/\.claude-plugin/plugin\.json	Adds marketplace entry for "using-skill-set" plugin and creates plugin manifest with SessionStart hook (triggers on startup|resume|clear|compact) configured to run session-start.sh script
Documentation README\.md, using-skill-set/SKILL\.md	Updates README with installation and usage details for the new core plugin; introduces SKILL.md with mandatory procedures, plugin catalog, critical rules, and standardized workflows for plugin leveraging
Plugin Detection Script using-skill-set/scripts/session-start\.sh	Bash script that scans for installed skill-set plugins, dynamically injects their names into SKILL.md placeholder ({{INSTALLED_PLUGINS}}), and outputs updated documentation

Sequence Diagram

sequenceDiagram
    participant Session as Claude Session
    participant Hook as SessionStart Hook
    participant Script as session-start.sh
    participant FS as File System
    participant Doc as SKILL.md

    Session->>Hook: startup|resume|clear|compact event
    Hook->>Script: Execute script
    Script->>FS: Scan plugins directory
    FS-->>Script: List installed plugins
    Script->>FS: Read SKILL.md template
    FS-->>Script: Return template content
    Script->>Script: Replace {{INSTALLED_PLUGINS}} placeholder
    Script->>Doc: Output updated documentation
    Doc-->>Session: Inject available plugins list

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Areas requiring attention:

• Verify bash script logic for plugin detection and directory scanning under user-specific paths
• Confirm placeholder replacement in SKILL.md works correctly when no plugins are installed
• Validate session-start hook matcher values and timing relative to Claude session lifecycle
• Review documentation accuracy of mandatory workflows and plugin usage rules

Possibly related PRs

• Add using-skill-set plugin with automatic session initialization #4: Directly related PR containing the same changes to the using-skill-set plugin components (manifest, documentation, and session-start script).

Poem

🐰 A plugin to rule them all with skill,
On session start, it bends to will—
Scripts scurry, plugins aligned,
Documentation refined!
Workflows bound, none left behind! ✨

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch using-skill-set-plugin

---

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 9b7b840 and be593a8.

📒 Files selected for processing (5)

• .claude-plugin/marketplace.json (1 hunks)
• README.md (2 hunks)
• using-skill-set/.claude-plugin/plugin.json (1 hunks)
• using-skill-set/SKILL.md (1 hunks)
• using-skill-set/scripts/session-start.sh (1 hunks)

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}