A developer migrated a Claude Code skill for debugging CI failures from using WebFetch (direct REST API calls) to the new CircleCI CLI. The migration required only a one-line prompt, and Claude Code autonomously explored the CLI's help tree to discover the right commands. Key improvements include replacing a polling loop with `circleci run watch` (a blocking call with meaningful exit codes), eliminating cache-busting hacks, and leveraging a `--condensed` flag that filters noisy output server-side for LLM consumption. Claude also discovered `circleci testresult list` as a faster shortcut for identifying failing tests. The broader lessons: prefer well-designed CLIs over raw APIs for AI agents, make CLIs discoverable via `--help`, and design CLI output to be token-efficient for LLM contexts.
Table of contents
The WebFetch approach and its ugly workaround §The new CircleCI CLI §The prompt that started the migration §What the CLI replaces §An unexpected shortcut §Why this matters beyond one skill §About this article §Need help with modernizing your architecture? §14.3K Impressions2 Comments