# Install a NeoSpark Skill

Every Skill page on <https://useneospark.com> offers the same two installation routes. This guide walks
through the Infographic Designer installation, screenshots included — every other Skill works identically,
with its own name and slug substituted.

Example page: <https://useneospark.com/skills/neospark-infographics/>

Both routes end in the same place: the Skill is connected to your agent and ready for the next task.
Free Skills need no account and no card. Paid Skills open with a plan.

![The Infographic Designer Skill page with the Download Skill and Copy install prompt buttons](https://useneospark.com/assets/docs/install/01-skill-page.webp)

Step 1 — open the Skill page. Both installation actions sit directly under the description, next to the
price and install count.

## Prerequisites

- An agent that reads `SKILL.md` or connects to an MCP server with sign-in — Claude Code, Codex, Cursor,
  GitHub Copilot, Gemini CLI, Windsurf, Cline, Grok and the other agents listed at
  <https://useneospark.com/install/>.
- A browser for the one-time sign-in (route 2 only, or when the CLI asks to authorize).
- No API key is required to connect: the CLI stores a revocable credential in your system keychain.

## Route 1 — Copy the install prompt (recommended)

On the Skill page, choose **Copy install prompt**, then paste it into your agent. For Infographic Designer
the prompt is:

```text
Read https://useneospark.com/install/agent.md and follow the instructions to connect NeoSpark,
then install the Infographic Designer Skill (neospark-infographics) and use it for my next task.
```

![The Install with one prompt panel showing the prompt and a Copy prompt button](https://useneospark.com/assets/docs/install/02-install-prompt.webp)

Step 2 — copy the prompt. The text already names the Skill and its slug, so the agent does not have to
guess what to install.

What happens next:

1. Your agent reads <https://useneospark.com/install/agent.md> and follows it.
2. It connects NeoSpark through the Skill's MCP tool — the installer writes the client configuration —
   and authorizes with the key scoped to that Skill.
3. It installs `neospark-infographics`, reads `SKILL.md` and confirms the package before your next ask.

To install and immediately use a Skill, the page's composer builds the same prompt with your task appended:

```text
Read https://useneospark.com/install/agent.md and follow the instructions to connect NeoSpark,
then install the Infographic Designer Skill (neospark-infographics) and use it for this: <your task>
```

The prompt works in any agent that reads `SKILL.md`; no per-editor build is involved.

## Route 2 — Download the Skill package

On the Skill page, choose **Download Skill**. If you are signed out, the sign-in dialog opens first and the
download resumes after you sign in.

![The NeoSpark sign-in dialog shown after choosing Download Skill while signed out](https://useneospark.com/assets/docs/install/03-sign-in.webp)

Step 3 (download route) — signed out, **Download Skill** opens the sign-in dialog. Sign in and the pending
download continues on its own.

The download is `neospark-<skill-id>-skill.zip` — for this example,
`neospark-neospark-infographics-skill.zip` — and contains:

- the native Claude Code / Codex skill (`skill/SKILL.md`),
- `install.sh` / `install.ps1` and a self-check script,
- the MCP client configuration (`claude.mcp.json`, `codex-config.toml`),
- a README,
- an `nsk_` key scoped to that one Skill.

Unpack it and run `./install.sh` (or `.\install.ps1` on Windows). The installer copies the skill into
Claude Code or Codex, writes the MCP configuration and runs a self-check. Restart the client, then use
`/neospark-<skill-id>`.

The key is `nsk_...` and works only against the MCP endpoint — never send it as an `X-API-Key`. It is
scoped to this one Skill and rotated on every download: only the newest package works, and the plaintext
key is returned once. Never write it into a project, a repository or a log.

## Verify the installation

- Ask your agent what the Skill does; it should answer from `SKILL.md`, not from its general knowledge.
- On the Skill page, the **At a glance** panel lists the version, execution mode and package shape that
  should match what the agent reports.
- Ask for one small piece of work in the Skill's output (`Image` for Infographic Designer) and check the
  result before relying on it for a larger task.

![The At a glance panel listing output, category, price, package, version, mode and slug](https://useneospark.com/assets/docs/install/04-at-a-glance.webp)

Step 4 — check the **At a glance** panel: for Infographic Designer it should read `v1.0.0`, `inline` and
`neospark-infographics`.

## Free and paid Skills

| | Free Skills | Paid Skills |
| --- | --- | --- |
| Account | Not required | Plan required |
| Card | Not required | Checkout through Stripe |
| Install route | Either route above | Either route above |
| Approval | — | Explicit yes before any paid run |

The Skill page's price line and the **At a glance** panel state which case applies. A free account starts
with 200 credits a month; the plans are listed at <https://useneospark.com/pricing/>.

## Update and uninstall

- **Update:** download the Skill again and re-run the installer. The new package replaces the old one and
  the previous key stops working.
- **Uninstall:** remove the MCP client entry (or the installed skill folder) and revoke the credential from
  your system keychain. Downloading the package again also rotates the key.

## Troubleshooting

| Symptom | Cause | Fix |
| --- | --- | --- |
| Agent cannot open `agent.md` | Network or URL typo | Open <https://useneospark.com/install/agent.md> directly in a browser. |
| Download opens the sign-in dialog | You are signed out | Sign in; the download resumes automatically. |
| `401` from the API | Key or session invalid | Download the newest package and reinstall; a new download rotates the old key. |
| `402` from the API | Balance too low | Top up, choose a plan, or switch to a free Skill. |
| `404` for a Skill | Removed, renamed or wrong slug | Re-check the catalogue at <https://useneospark.com/browse/>. |
| Old MCP key stopped working | A newer download rotated it | Use the key from the latest package only. |

## Reference

- Machine-readable agent guide: <https://useneospark.com/install/agent.md>
- Human install guide: <https://useneospark.com/install/>
- Skill specification: <https://useneospark.com/neospark-skill-spec.md>
- API reference: <https://api.useneospark.com/docs>
