Agent Skills

Add the published HeadlessX skill to supported AI coding agents and let them use the `headlessx` CLI correctly.

by @saifyxpro

HeadlessX ships a CLI skill in the main repository so AI coding agents can install it and follow the published CLI workflow.

Install the skill


This installs the cli skill from the HeadlessX repository.

What the skill gives the agent


  • the published package name: @headlessx-cli/core
  • the correct command: headlessx
  • login and credential setup patterns
  • markdown-first CLI output guidance
  • working command patterns for Website, Google AI Search, Tavily, Exa, YouTube, jobs, and operators

Agent tools that fit this flow


The skill works well with AI agents and coding tools that support the skills installer flow, including:

  • Cursor
  • Claude Code
  • Warp
  • Windsurf
  • OpenCode
  • OpenClaw
  • Antigravity
  • similar agent shells with skills support

Typical workflow


  1. install the skill
  2. install the CLI package if it is not already present
  3. run headlessx login
  4. use headlessx commands from the agent instead of inventing route shapes manually

CLI install:

When to prefer skills vs MCP


  • use Agent Skills when the agent should drive the published CLI directly
  • use MCP when the client wants remote tool discovery over /mcp
  • use raw HTTP only when you need direct backend control inside application code

Related Docs

Next Steps