Agent Skill

Open Agent Skills format

Give your coding agent a safe path into QuickBooks Desktop.

Install one portable skill, grant a Developer API Key to one or more projects, and let developers diagnose, configure, and verify Boost Connect QBD from Codex, Claude Code, Cursor, and other compatible agents.

Install the Skill View Source

Project-Bounded Access

Choose Admin or Custom scopes, then assign exact projects.

Connector Proof

Check API identity, connection ownership, Web Connector, and QuickBooks separately.

Bundled CLI

Machine-readable JSON, stdin secrets, and CI environment support.

Four Steps

From install to verified connector.

The skill is instructions; the CLI is the execution layer; the Developer API Key is the permission boundary. It is not a portal JWT.

  1. 1

    Install the Universal Skill

    The installer writes the skill to .agents/skills at project scope for compatible agents.

    npx --yes skills@1.5.16 add 'https://github.com/BoostPlugins/boost-connect-qbd-skill/tree/v0.1.2/skills/boost-connect-qbd' --agent universal --copy -y
  2. 2

    Create a Developer API Key

    An account owner selects Admin or Custom scopes, assigns one or more projects, chooses expiry, and copies the one-time secret. The key is not a portal JWT.

    Create API Key
  3. 3

    Authenticate Privately

    Keep the token out of chat history and shell arguments. The CLI stores it in a private local credential file.

    printf '%s' "$BOOST_CONNECT_QBD_TOKEN" | node .agents/skills/boost-connect-qbd/scripts/boost-connect-qbd.mjs auth login --token-stdin
  4. 4

    Prove the Connector

    List an assigned connection, then use Admin or Custom diagnostics:read and qbd:read scopes to verify identity, Web Connector health, and a live read-only QuickBooks CompanyQuery.

    node .agents/skills/boost-connect-qbd/scripts/boost-connect-qbd.mjs doctor --connection-id <connection-id> --verify-qbd

Admin

Every currently supported public developer scope, limited to selected projects.

Custom

Only explicitly selected scopes, for CI jobs and least-privilege integrations.

Project Assignments

One key can cover several current projects. New projects require explicit assignment.