Multi-project dashboard for managing PopKit-enabled projects. Shows health scores, recent activity, and quick actions across all registered projects. Use when switching between projects, checking overall status, or managing project registry. Do NOT use if only working in a single project - use morning routine or next-action instead.
/plugin marketplace add jrc1883/popkit-claude/plugin install popkit@popkit-marketplaceThis skill inherits all available tools. When active, it can use any tool Claude has access to.
scripts/gather_metrics.pytemplates/dashboard.md.templateworkflows/dashboard-workflow.jsonProvides a unified view across all PopKit-enabled projects, showing health scores, activity status, and enabling quick context switching.
Core principle: Quick status overview with actionable intelligence for multi-project developers.
Trigger: /popkit:dashboard command or skill invocation.
Invoke this skill when:
The project registry is stored globally at ~/.claude/popkit/projects.json.
from project_registry import load_registry, list_projects
# Load all registered projects
registry = load_registry()
projects = list_projects()
print(f"Total projects: {len(projects)}")
Show the main dashboard view:
+===============================================================+
| PopKit Dashboard |
+===============================================================+
Total: 5 | Healthy: 3 | Warning: 1 | Critical: 1
-------------------------------------------------------------
| Project | Health | Issues | Last Active |
-------------------------------------------------------------
| popkit | + 92 | 5 | 2 min ago |
| popkit-cloud | ~ 78 | 3 | 1 hour ago |
| reseller-central | + 88 | 12 | 3 days ago |
| my-website | ! 45 | 0 | 2 weeks ago |
-------------------------------------------------------------
Commands: add <path> | remove <name> | refresh | switch <name>
Use the health calculator for detailed scores:
from health_calculator import calculate_health_score, calculate_quick_health
# Full health check (slower, more accurate)
result = calculate_health_score("/path/to/project")
print(f"Health: {result['score']}/100")
# Quick health check (git + activity only)
quick_score = calculate_quick_health("/path/to/project")
print(f"Quick Health: {quick_score}/100")
| Component | Points | Criteria |
|---|---|---|
| Git Status | 20 | Clean working tree (+20), uncommitted (-5/10 files), unpushed (-5/commit) |
| Build Status | 20 | Passed (+20), warnings (-2 each), failed (0) |
| Test Coverage | 20 | >80% (+20), 60-80% (+15), <60% (+10), none (+5) |
| Issue Health | 20 | No stale (+20), -2 per stale issue (>30 days) |
| Activity | 20 | Today (+20), week (+15), month (+10), older (+5) |
/popkit:dashboard
Display the full dashboard with all projects, health scores, and quick actions.
/popkit:dashboard add /path/to/project
/popkit:dashboard add . # Current directory
Register a project in the global registry. Auto-detects:
from project_registry import add_project
success, message = add_project("/path/to/project", tags=["active"])
print(message)
/popkit:dashboard remove project-name
Remove a project from registry (does not delete files).
from project_registry import remove_project
success, message = remove_project("my-project")
print(message)
/popkit:dashboard refresh # Refresh all
/popkit:dashboard refresh popkit # Refresh one
Recalculate health scores for all or specific projects:
from project_registry import list_projects, update_health_score
from health_calculator import calculate_health_score
for project in list_projects():
result = calculate_health_score(project["path"])
update_health_score(project["name"], result["score"])
print(f"{project['name']}: {result['score']}/100")
/popkit:dashboard switch project-name
Change context to a different project. Updates activity timestamp and provides project summary.
from project_registry import get_project, touch_project
import os
project = get_project("popkit")
if project:
os.chdir(project["path"])
touch_project(project["path"])
print(f"Switched to: {project['name']}")
Automatically discover projects in common locations:
from project_registry import discover_projects, add_project
# Search common dev directories
discovered = discover_projects()
for project in discovered:
print(f"Found: {project['name']} at {project['path']}")
# Add discovered projects
for project in discovered:
add_project(project["path"])
Use AskUserQuestion for interactive operations:
Use AskUserQuestion tool with:
- question: "Which project would you like to switch to?"
- header: "Switch"
- options:
- label: "popkit"
description: "Health: 92 | Last active: 2 min ago"
- label: "popkit-cloud"
description: "Health: 78 | Last active: 1 hour ago"
- label: "reseller-central"
description: "Health: 88 | Last active: 3 days ago"
- multiSelect: false
Show recent activity across all projects:
Recent Activity (across all projects)
-------------------------------------
| Project | Action | Time |
|------------------|------------------|------------|
| popkit | Closed #117 | 2 min ago |
| popkit-cloud | Pushed main | 1 hour ago |
| reseller-central | Failed build | 3 days ago |
Tag projects for filtering:
from project_registry import add_tag, get_projects_by_tag
# Add tags
add_tag("popkit", "active")
add_tag("reseller-central", "client-work")
# Filter by tag
active_projects = get_projects_by_tag("active")
Identify projects needing attention:
from project_registry import get_unhealthy_projects
# Projects with health < 70
unhealthy = get_unhealthy_projects(threshold=70)
if unhealthy:
print("Projects needing attention:")
for p in unhealthy:
print(f" ! {p['name']}: {p['healthScore']}/100")
Configure dashboard behavior in registry:
{
"settings": {
"autoDiscover": true,
"healthCheckInterval": "daily",
"maxInactiveProjects": 20
}
}
| Situation | Response |
|---|---|
| No projects registered | Suggest /popkit:dashboard add . |
| Project path not found | Remove from registry with warning |
| Health check fails | Show "--" for health, log error |
| gh CLI unavailable | Skip issue counts |
/popkit:dashboard command - User-facing wrapper/popkit:routine morning - Single-project health check/popkit:next - Context-aware recommendationshooks/utils/project_registry.py - Registry CRUD operationshooks/utils/health_calculator.py - Health score calculationThis skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code.
This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.
This skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate tool use", "implement prompt-based hooks", "use ${CLAUDE_PLUGIN_ROOT}", "set up event-driven automation", "block dangerous commands", or mentions hook events (PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification). Provides comprehensive guidance for creating and implementing Claude Code plugin hooks with focus on advanced prompt-based hooks API.