@truekeep/skill
v0.1.0
Published
Install a per-portal TrueKeep brand skill into Claude Code, Cursor, OpenCode, and other AI harnesses.
Maintainers
Readme
@truekeep/skill
Install a per-portal TrueKeep brand skill into Claude Code, Cursor, OpenCode, and other AI harnesses.
Quick start
# From a project root where you want the skill installed:
npx @truekeep/skill install --portal <slug> --url https://truekeep.ai --install-token op-install-...The --install-token is a short-lived (5-minute) single-use token minted from your TrueKeep portal's /connect page. Click "Install skill" there and copy the generated command.
You can also pass a long-lived API token (sk-mcp-...) via --token instead of --install-token.
Commands
# With a global install (npm install -g @truekeep/skill):
truekeep install --portal <slug> --url <truekeep-url> [--token <api-token> | --install-token <install-token>] [--global] [--harness <name>]
truekeep update --portal <slug>
truekeep list
truekeep remove --portal <slug>
# Without a global install, prefix each command with "npx @truekeep/skill":
npx @truekeep/skill install --portal niftic --url https://truekeep.ai --install-token op-install-xyzinstall— fetches the per-portal skill bundle and writes it to the detected harness's skills dir. Default is project-level (<cwd>/.claude/skills/...); use--globalfor user-level (~/.claude/skills/...).update— re-fetches and overwrites a previously installed portal's skill. Uses the source URL stored inskills-lock.json.list— prints installed portals fromskills-lock.json.remove— deletes a portal's skill directory and removes the lock entry.
Supported harnesses
Auto-detected by inspecting the target directory for known config dirs:
.claude/— Claude Code.cursor/— Cursor.opencode/— OpenCode.gemini/— Gemini CLI.kiro/— Kiro.pi/— Pi.qoder/— Qoder.rovodev/— Rovo Dev.trae/— Trae
If more than one is detected, you'll be prompted to pick. Override with --harness <name>.
Lock file
A skills-lock.json is written to the project root tracking installed portals — source URL, generated-at timestamp, computed hash. Update commands use this to find the source.
License
MIT
