This skill should be used when the user asks about "Constellation errors", "fix Constellation", "debug Constellation", "Constellation not working", "API connection issues", "indexing problems", "MCP server", "Failed to reconnect", mentions any Constellation error codes (AUTH_ERROR, PROJECT_NOT_INDEXED, etc.), or when Constellation commands fail.
From constellationnpx claudepluginhub shiftinbits/constellation-claude --plugin constellationThis skill uses the workspace's default tool permissions.
references/error-codes.mdGuides Payload CMS config (payload.config.ts), collections, fields, hooks, access control, APIs. Debugs validation errors, security, relationships, queries, transactions, hook behavior.
Designs KPI dashboards with metrics selection (MRR, churn, LTV/CAC), visualization best practices, real-time monitoring, and hierarchy for executives, operations, and product teams.
Transforms raw data into narratives with story structures, visuals, and frameworks for executive presentations, analytics reports, and stakeholder communications.
Quick diagnostic procedures for Constellation plugin issues.
Issue Reported
|
v
Can mcp__constellation__code_intel be called?
| |
YES NO
| |
v v
API Error MCP Server Issue
(has code) (see MCP Diagnosis)
|
v
Check error.code:
- AUTH_ERROR --> Authentication section
- PROJECT_NOT_INDEXED --> Indexing section
- SYMBOL_NOT_FOUND --> Query Issues section
- API_UNREACHABLE --> Connectivity section
Symptom: "Failed to reconnect to plugin:constellation:constellation" or tool calls fail entirely.
Cause: The MCP server isn't starting or is crashing.
Quick Fixes:
Restart Claude Code - MCP connections initialize at startup
Verify .mcp.json configuration:
{
"mcpServers": {
"constellation": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@constellationdev/mcp@latest"],
"tools": ["code_intel"]
}
}
}
Symptom: "Authentication failed" or "Invalid API key"
Quick Fixes:
Configure credentials:
constellation auth
Check if key is set:
echo $CONSTELLATION_ACCESS_KEY
If key is expired: Regenerate in Constellation web UI under Settings > API Keys
Symptom: "Project not indexed" or empty results
Quick Fixes:
Index the project:
cd /path/to/your/project
constellation index --full
Force reindex if stale:
constellation index --full --force
Symptom: Timeout or connection refused
Quick Fixes:
Check network connectivity
Check Constellation status at https://status.constellationdev.io/
These are typically not errors - the item simply wasn't found in the index.
Troubleshooting:
Run /constellation:diagnose for a quick health check that tests:
See references/error-codes.md for complete error code documentation.