← Back to Help Center

AI Agent Skills

Use Skills + MCP in Cursor, Hermes, or Claude Desktop — install, prompts, and troubleshooting.

7 min read

# AI Agent Skills Guide

Use Skills + MCP to run CitePath from Cursor, Hermes, Claude Desktop, or any MCP-compatible agent — in plain language, without memorizing API names.

Skills vs MCP

Layer What it is What you do
Skills Step-by-step playbooks (SKILL.md) Install once; talk naturally
MCP Live connection to CitePath (/mcp) Add the MCP server in your agent

Skills are instructions. MCP is the engine. Skills alone cannot fetch data or write articles — MCP must be connected.

You (natural language)
    → Skill (workflow & defaults)
        → MCP tools (API calls)
            → CitePath backend

Setup (about 5 minutes)

Step 1 — Connect MCP (required)

mcp_servers:
  citepath-geo:
    url: /mcp
    enabled: true
    connect_timeout: 60
    timeout: 300

Restart the agent (Hermes: /reload-mcp).

Step 2 — Install Skills

One command (Hermes — macOS / Linux / Git Bash):

curl -fsSL /skills/install.sh | bash

Windows Hermes Desktop (PowerShell):

irm /skills/install.ps1 | iex

From GitHub:

curl -fsSL https://raw.githubusercontent.com/Adaku10000/citepath/main/skills/hermes/install.sh | bash

Catalog: /skills/manifest.json

The 8 Skills (what to say)

You do not need to name skills in chat — the agent picks the right one. Examples:

Goal Example prompt Skill used
GEO snapshot Run a 60-second GEO snapshot for https://example.com and give me the HTML report. citepath-geo-quick-audit
Full audit Run a full GEO audit for https://example.com. citepath-geo-full-audit
Brand KPIs How is our brand doing — visibility, citations, SOV, sentiment? citepath-geo-brand-insights
Write article Write a GEO competitor comparison article for our site. citepath-geo-compose
Publish Publish the article you just wrote to WordPress as a draft. citepath-geo-publish
Markdown only Draft markdown only — no meta or schema. citepath-geo-write-draft
Automation Run the full pipeline: topic → compose → quality → publish. citepath-geo-automation
MCP missing (Auto) setup guide when MCP is not connected citepath-geo-mcp-setup

Default article path

Prefer citepath-geo-compose (meta, schema, SEO keywords, optional hero images, quality gate). Use citepath-geo-write-draft only when the user explicitly wants markdown without meta/schema.

Typical flow

  1. Connect MCP
  2. Install skills
  3. Ask in natural language
  4. Agent selects skill + MCP tools
  5. Review draft / report
  6. Publish only if asked → citepath-geo-publish / publish_compose

Credits

  • Credits → audits, compose, and automation consume CitePath credits.

Troubleshooting

Symptom Fix
Agent says MCP not connected Add the citepath-geo MCP block above and /reload-mcp
401 / auth failed Confirm the citepath-geo MCP block, then /reload-mcp
insufficient_credits Add credits on the site billing page

More