Back to articles
I Built a Diagnostic CLI for Claude Code Skills — Here's What 8 Rules Caught That I Missed
How-ToTools

I Built a Diagnostic CLI for Claude Code Skills — Here's What 8 Rules Caught That I Missed

via Dev.tothestack_ai

Most of my Claude Code skills were broken and I had no idea. I had 23 skill files, felt productive, and assumed Claude was using all of them. Then I built a diagnostic tool, ran it on my own setup, and 14 of those 23 skills had structural issues that silently degraded how Claude interpreted them. That's a 61% failure rate on files I had personally written and considered finished. TL;DR: pulser is a CLI that scans Claude Code skill files, classifies them by type, runs 8 diagnostic rules, generates prescriptions, and auto-fixes issues with backup and rollback. I ran it on 23 skills and found 14 had problems — missing frontmatter fields, ambiguous trigger conditions, conflicting instructions. One command. Zero config. npx pulser-cli and you're done. The Problem: Claude Code Skills Have No Validation Layer Claude Code skills are markdown files in ~/.claude/skills/ that change how Claude behaves — and there is no built-in way to verify they're structured correctly. You write a markdown file

Continue reading on Dev.to

Opens in a new tab

Read Full Article
7 views

Related Articles