@kkauto/kkauto-skill

Install and update kkAuto AI-agent skills plus MCP config for Claude Code, OpenCode, Codex, Antigravity CLI, and Cursor.

kkauto-skill helps AI agents use the automation services provided by kkauto.net. KKAuto is a platform for Facebook and socials automation: teams can manage accounts, configure workflows, generate AI-assisted content, automate posting and engagement, search groups and leads, and monitor repetitive social operations from a central web system. It is built for shops, marketers, agencies, and operators who need scalable kkauto, facebook, automation, and socials workflows.

Keywords: kkauto, facebook, automation, socials.

Published npm package: @kkauto/kkauto-skill. Installed executable and local state keep the unscoped name: kkauto-skill and ~/.config/kkauto-skill.

Runtime MCP package: @kkauto/kkauto-mcp. Installed MCP command stays kkauto-mcp:

npx -y @kkauto/kkauto-mcp

Quick Start

npx @kkauto/kkauto-skill install

Interactive install (TTY):

1. Select AI agents (default: all checked)
2. Enter kkAuto URL + API token from /wtadmin/mcp
3. Pick Antigravity scopes when Antigravity is selected
4. Pick Cursor scope when Cursor is selected (Global = ~/.cursor/mcp.json only; Project = .cursor/mcp.json + rules in the current directory)
5. Install skills + MCP config for each selected agent

Credentials are stored in ~/.config/kkauto-skill/credentials.env. MCP configs use a wrapper that loads this file; real tokens are not written inline to .cursor/mcp.json or other agent configs by default.

Cursor install scopes

| Scope | MCP config | kkAuto rules (.mdc) | | --- | --- | --- | | project (default) | <project>/.cursor/mcp.json | <project>/.cursor/rules/kkauto-*.mdc | | global | ~/.cursor/mcp.json | not installed |

Run install from the target project directory when using project scope. Global MCP applies to every Cursor workspace; install project scope separately if you need kkAuto rules in a repo.

Commands

npx @kkauto/kkauto-skill install
npx @kkauto/kkauto-skill install --agent all --no-interactive --use-placeholders
npx @kkauto/kkauto-skill install --agent antigravity --antigravity-scopes global
npx @kkauto/kkauto-skill install --agent cursor --cursor-scope global   # MCP only, all projects
npx @kkauto/kkauto-skill install --agent cursor --cursor-scope project  # MCP + rules in cwd
npx @kkauto/kkauto-skill update
npx @kkauto/kkauto-skill list
npx @kkauto/kkauto-skill print-config --agent codex
npx @kkauto/kkauto-skill doctor --json

Non-interactive with credentials:

KK_API_BASE_URL=https://your-tenant.example.com \
KK_API_TOKEN=paste-token-here \
npx @kkauto/kkauto-skill install --agent all --no-interactive

Do not paste real tokens into chat, issues, logs, or docs.

Default Packs

• core
• source-workflows
• fb-posts

See docs/packs.md for all packs.

User guides

Step-by-step install and skill usage (English and Vietnamese):

• guides/README.md

Supported Agents

Supported values: claude, opencode, codex, antigravity, cursor.

See docs/agents.md for exact paths, Antigravity scopes, and MCP behavior.

License

MIT