Skip to content

firecrawl-monitor skill: description exceeds Claude Code's 1024-char limit, skill fails to load #160

Description

@gx0404

Problem

The frontmatter description in skills/firecrawl-monitor/SKILL.md is 1135 characters, but Claude Code enforces a 1024-character maximum on skill descriptions. The skill is rejected at load time with:

Skill description is too long (>1024): firecrawl-monitor

As a result the skill never loads and can't be triggered at all.

Reproduce

  1. Install skills via the firecrawl CLI (firecrawl skills install)
  2. Launch Claude Code with ~/.agents/skills (or wherever the skills land) as a skills directory
  3. Claude Code logs the error above and skips the skill

Verified against main as of 2026-07-20 — the description is still 1135 chars. Other skills in the repo appear to be within the limit; firecrawl-monitor is the only one over.

Suggested fix

Trim the description to ≤1024 chars and move the detailed trigger-phrase list into the SKILL.md body (which only loads after the skill is triggered, so nothing is lost). For example, this ~770-char version keeps both scenarios (page monitors + web monitors) and the key trigger words:

Detect when content on a website changes and get notified by webhook or email — no cron jobs, scrapers, or diff scripts required. Use whenever the user wants to track changes on a page (competitor pricing, docs, changelogs, blogs, job postings, status pages) or says "monitor", "watch", "track", "alert me when", "notify when X changes". Also covers web monitors — watching the web itself for new results (product launches, funding rounds, papers, news, mentions) via search queries plus a goal instead of a URL, e.g. "monitor the web for X". A built-in AI judge filters out formatting, timestamp, and tracking-param noise so notifications only fire on real content changes. Prefer this over repeated one-off scrapes whenever the same URL needs checking more than once.

Happy to send a PR if that's easier.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions