skills.rest
jamsdoescode
jamsdoescodeCOMMUNITY
Explore all skills by this author →
GitHub

clicky-dev-setup-doctor

Diagnose and fix local development environment, toolchain, and agent runtime setup problems.

Updated Jul 7, 2026
Search Tags:#troubleshooting#mcp#dev environment#api keys#diagnose#node#localhost
One-click install
npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill clicky-dev-setup-doctor-jamsdoescode
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clicky-dev-setup-doctor
Source: https://github.com/jamsdoescode/Erik-s-Portfolio/tree/main/openclicky/AppResources/OpenClicky/OpenClickyBundledSkills/clicky-dev-setup-doctor
Command: npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill clicky-dev-setup-doctor-jamsdoescode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Local development environments break in confusing ways: missing API keys, wrong Node versions, dead localhost ports, misconfigured MCP servers, or broken package managers. This Skill diagnoses those failures in plain language and applies the smallest safe fix so non-expert builders can get unblocked. ## Core Features & Use Cases - Environment Diagnosis: Checks versions, env files, running processes, ports, auth status, and logs before changing anything. - Toolchain Repair: Troubleshoots npm, node, pnpm, Python, Supabase, Cloudflare/Wrangler, Codex, Claude Code, and MCP server setup. - Safe Fixes with Verification: Applies minimal fixes without touching .env secrets or production services, then re-runs the failing command or health check to confirm. - Use Case: A user's dev server will not start and Codex reports an auth error. The Skill inspects the project folder, identifies the missing login, explains the issue, and provides the exact next command. ## Quick Start Ask the agent to diagnose why your localhost dev server or MCP connection is failing and tell you the exact command to run next.

Frequently Asked Questions about clicky-dev-setup-doctor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix a localhost dev server that will not start?▼

First check which process holds the port, confirm the correct Node or Python version, and review server logs. The Skill inspects these before acting, then starts the server only when a working preview was requested and verifies the port responds.

How to troubleshoot MCP server connection problems?▼

Check the MCP server configuration, auth status, and tool discovery output before changing anything. The Skill verifies connection status after any fix and reports the exact missing permission or login when authentication is the blocker.

Why does my npm or node command fail in a new project?▼

Common causes are wrong Node versions, missing dependencies, or corrupted package manager state. The Skill checks versions and toolchain status first, explains the failure in plain language, and applies the smallest safe fix.

Can this tool fix Codex or Claude Code authentication errors?▼

Yes, it diagnoses local auth and configuration issues for Codex and Claude Code by checking login status and environment setup. If a permission or login is missing, it states the exact setup action required.

When should I not use a dev environment diagnostic skill?▼

Do not use it for normal feature work, PRs, commits, or CI review, which belong to repo-operation workflows. It also cannot connect external app accounts when no connection runtime is shipped in the build.

Related Skills

Explore More Software Engineering Skills→
novelsaganovelsaga

nix-env

Configures and maintains a Nix-based development environment for the LONGSAMA project.

Official
Intermediate
ESO-ToolkitESO-Toolkit
2

deploy-preview

Deploy local builds to the ESO-Toolkit GitHub Pages preview site.

Official
Intermediate
michaelvolzmichaelvolz

test-browser

Run agent-browser tests on git-changed web routes before merging.

Community
Advanced
johnnymo87johnnymo87
4

Rebuilding the Devbox

Rebuild NixOS devbox systems and apply user configuration changes.

Community
Advanced