gstack-industrial

English | 繁體中文 | 日本語

Let Claude Code automatically pick the right skill for you

---

What is this?

You have hundreds of Claude Code skills installed but can never remember which one to use?

gstack-industrial solves this:

• Auto-Discovery — Scans all installed SKILL.md files and builds routing rules automatically
• Auto-Suggest — Recommends the best skill based on your message and project state
• Template System — Write standards once, auto-apply to all skills
• Zero Interruption — Only suggests when truly helpful, won't spam you

---

Comparison with original gstack

Original gstack	gstack-industrial
Provides 28 skills	Auto-routes to any installed skill
You need to remember which skill	Auto-suggests the best skill
Manually install, manually remember	Auto-scans new skills on session start
-	Anti-spam mechanisms (cooldown, limits)
-	Template system (shared standard sections)

In short: gstack provides skills, gstack-industrial automates discovery and routing

---

Quick Start

Installation (2 minutes)

# 1. Clone
git clone https://github.com/kevintseng/gstack-industrial.git
cd gstack-industrial

# 2. Auto-install
bun install

The installer automatically:

• Copies skill-router to ~/.claude/skills/templates/skill-router/
• Copies hooks to ~/.claude/hooks/
• Scans all installed skills and builds routing rules
• Registers UserPromptSubmit hook (auto-suggest)
• Registers SessionStart hook (auto-discovery)
• Creates default config

Installation is idempotent — running it again won't create duplicate hooks.

Usage

Auto mode (recommended): Do nothing, Claude will auto-suggest at the right time

You say: "I need to think about how to implement this feature"
Claude auto-responds:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Suggestion: Use @brainstorming
   Organize ideas with structured thinking
   (Say "yes" to run, or "stop suggesting" to disable)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Manual testing:

cd ~/.claude/skills/templates/skill-router
bun run test-cli.ts "I need to review my code" --debug

---

Auto-Discovery (v1.1.0)

On every Claude Code session start, auto-discover scans all SKILL.md files under ~/.claude/skills/:

1. Parse frontmatter — Reads name and description fields
2. Extract keywords — Pulls trigger words from descriptions (quoted phrases, slash commands, key terms)
3. Infer phase — Determines applicable development phase (think/plan/build/review/test/ship)
4. Merge into matchers.json — New skills are added automatically; manually-written rules are never overwritten

Features:

• Deduplication: when the same skill exists in multiple sources, priority is gstack > plugin > standalone
• Idempotent: running repeatedly won't create duplicate entries
• Manual rule protection: autoDiscovered: true flag distinguishes auto vs manual rules
• 1-hour cooldown: avoids re-scanning on every session resume

Manual trigger:

# Scan and update
bun run discover

# Preview (no write)
bun run discover:dry

---

How does it know what to suggest?

Smart Router analyzes:

1. Your words — "brainstorm" -> suggests brainstorming skill
2. Project state — Uncommitted files -> suggests code review
3. Development phase — "ready to merge" -> suggests finishing-branch skill
4. Score threshold — Only skills scoring >= 80 are suggested

Anti-spam mechanisms:

• No repeat suggestions within 5 minutes
• Max 10 suggestions per conversation
• Same skill won't be suggested 3 times in a row

---

Advanced Configuration (Optional)

Works out of the box, but you can customize:

Disable suggestions for certain skills: Edit ~/.claude/config/skill-router.json:

{
  "disabledSkills": ["skill-judge"]
}

Set quiet hours (no interruptions at night):

{
  "quietHours": {
    "enabled": true,
    "start": "22:00",
    "end": "08:00"
  }
}

Boost priority for specific skills:

{
  "priorityBoosts": {
    "brainstorming": 20,
    "systematic-debugging": 15
  }
}

Details: INSTALL.md

---

File Structure

gstack-industrial/
├── skill-router/
│   ├── auto-discover.ts          # Scans SKILL.md -> matchers.json
│   ├── matchers.json             # Routing rules (manual + auto)
│   ├── matcher-engine.ts         # Scoring engine
│   ├── context-extractor.ts      # Context extraction
│   ├── types.ts                  # Type definitions
│   ├── index.ts                  # Router entry point
│   ├── gen-skill-docs.ts         # Template generator
│   ├── suggestion-formatter.ts   # Suggestion formatter
│   └── test-cli.ts               # CLI test tool
├── hooks/
│   ├── skill-router-before-message.ts    # UserPromptSubmit hook
│   └── skill-discovery-session-start.sh  # SessionStart hook
├── standard-sections/            # Shared template sections
├── install.ts                    # Install script
├── package.json
└── README.md

---

Uninstall

# Remove installed files
rm -rf ~/.claude/skills/templates/skill-router
rm ~/.claude/skills/templates/*-section.md
rm ~/.claude/hooks/skill-router-before-message.ts
rm ~/.claude/hooks/skill-discovery-session-start.sh
rm ~/.claude/config/skill-router.json
rm ~/.claude/sessions/skill-router-state.json
rm ~/.claude/state/skill-discovery-last-run

# Manually edit ~/.claude/settings.json to remove related hooks

---

Contributing

PRs welcome! Process:

1. Fork this repo
2. Create a feature branch
3. Test your changes
4. Submit PR

See CONTRIBUTING.md

---

License

MIT License - see LICENSE

---

Acknowledgments

• Garry Tan — Original gstack philosophy
• Claude Code — Integration platform