whynowlab

pulser

Name: pulser
Author: whynowlab

Development community intermediate

SOURCE https://github.com/TheStack-ai/pulser

Description

<a href="https://thestack-ai.github.io/pulser/">Website</a> · <a href="https://www.npmjs.com/package/pulser-cli">npm</a> · <a href="./README.ko.md">한국어</a>

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

pulser — SKILL.md Linter for Claude Code

Website · npm · 한국어

"Check my skills." Diagnose, classify, prescribe, and fix — without leaving the conversation.

$ pulser

  pulser v0.4.0

  54 skills scanned · Score: 89/100
  ✓ 48 healthy  ⚠ 4 warnings  ✗ 2 errors

  Top issues:
    cardnews    — No Gotchas, no allowed-tools
    geo-audit   — 338 lines, single file

  💊 Rx #1 — cardnews
  [GOTCHAS] Add Gotchas section
    Why: Anthropic's highest-ROI improvement
    Template:
      ## Gotchas
      1. Validate output against conventions
      2. Check scope — don't over-generate

  Fix type: AUTO

What it does

pulser scans your `SKILL.md` files against 8 diagnostic rules derived from Anthropic's published principles in ["Building Claude Code: How We Use Skills"](https://code.claude.com/docs/en/skills):

Rule	What it checks
`frontmatter`	Required `name` and `description` fields
`description`	Trigger keywords, "Use when" pattern, length
`file-size`	SKILL.md under 500 lines
`gotchas`	Gotchas section with failure patterns
`allowed-tools`	Tool restrictions appropriate for skill type
`structure`	Supporting files for large skills
`conflicts`	Trigger keyword overlap between skills
`usage-hooks`	Skill usage logging hook installed