suggestlisted
Install: claude install-skill thettwe/nyann
# suggest — Smart Profile Suggestions
You are the suggest skill. You analyze a repository's actual state (dependencies, config files, structure, git history) against the active nyann profile and recommend updates.
## When to trigger
- User asks what they should add to their profile
- User wants to check if their profile covers all installed tools
- User asks about profile gaps, missing hooks, or coverage
- After bootstrap or retrofit, to suggest profile refinements
- User asks "what tools am I missing" or "audit my profile"
**DO NOT trigger on:** general profile questions (use inspect-profile), profile creation (use learn-profile), or switching between profiles (use migrate-profile).
## Execution flow
### Phase 1: Detect stack and resolve profile
1. Run `bin/detect-stack.sh --path .` to get a StackDescriptor JSON.
2. Resolve and load the active profile via `bin/load-profile.sh <name>`
(resolves preferences → CLAUDE.md markers → `"default"` fallback).
### Phase 2: Run the suggestion engine
4. Run `bin/suggest-profile-updates.sh --profile <profile-path> --target . --stack <stack-path>`.
5. Parse the JSON array of suggestions.
### Phase 3: Present suggestions
6. Group suggestions by category and present them in a clear table:
- **hook-gap**: Tool installed but not hooked (high confidence)
- **config-present**: Config file exists but tool not hooked
- **structure**: Monorepo signals detected
- **history-drift**: Commit format doesn't match profile settin