aircrushin/promptminder/promptminder-cli-skill

Claude Code and agent skill by aircrushin/promptminder

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Use when running PromptMinder CLI or agent-wrapper commands, configuring its token, or debugging team-scoped JSON I/O errors.

Install

npx vskill@latest install aircrushin/promptminder/promptminder-cli-skill

SKILL.md

PromptMinder CLI

Overview

promptminder is a JSON-in / JSON-out CLI for managing prompts, tags, and teams via the PromptMinder API. Every success response goes to stdout; every error goes to stderr as {"error":{"message":"...","status":null}}.

Install the CLI first:

bash
npm i -g @aircrushin/promptminder-cli

Auth and Token

Token resolution order: --token flag -> PROMPTMINDER_TOKEN env var -> saved config.

bash
# One-time interactive login (saves token to ~/.promptminder/config.json)
promptminder auth login --token pm_xxx
 
# CI / scripts: prefer env var, no saved state needed
export PROMPTMINDER_TOKEN=pm_xxx
promptminder prompt list

promptminder auth logout removes the saved token.

Quick Reference

text
promptminder auth login --token <token>
promptminder team list
promptminder prompt list   [--team <id>] [--tag <tag>] [--search <text>] [--page <n>] [--limit <n>]
promptminder prompt get    <id> [--team <id>]
promptminder prompt create --title <text> --content <text> [--description <text>] [--tags <csv>] [--version <text>] [--team <id>]
promptminder prompt update <id> [--title <text>] [--content <text>] [--team <id>]
promptminder prompt delete <id> --yes [--team <id>]
promptminder tag list      [--team <id>] [--include-public <true|false>]
promptminder tag create    --name <text> [--team <id>]
promptminder tag update    <id> --name <text> [--team <id>]
promptminder tag delete    <id> --yes [--team <id>]

Run promptminder help for up-to-date full usage.

Team Scoping

Pass --team <uuid> to target a non-personal workspace. Omitting --team targets the personal workspace. The flag is always --team, never --team-id.

bash
promptminder prompt list --team team-uuid-xyz

Content Input Sources

prompt create and prompt update accept content three ways - use exactly one:

FlagWhen to use
--content "..."Inline short text
--content-file path/to/file.txtContent from a local file
--stdinPipe content from another command

Agent Wrapper (promptminder-agent)

Use promptminder-agent in scripts and AI agent pipelines. Actions use dot notation, not space-separated subcommands. Input is a single --input JSON object, not individual flags.

bash
# List prompts
promptminder-agent prompt.list
 
# Get a specific prompt
promptminder-agent prompt.get --input '{"id":"prompt-id"}'
 
# Create a prompt in a team
promptminder-agent prompt.create --input '{"title":"SQL helper","content":"Write clean SQL","team":"team-uuid"}'
 
# Pipe JSON from a file
cat payload.json | promptminder-agent prompt.create --stdin

Available actions: team.list, prompt.list, prompt.get, prompt.create, prompt.update, prompt.delete, tag.list, tag.create, tag.update, tag.delete.

Run promptminder-agent help for the full list with input field requirements.

Error Triage

Stderr messageCauseFix
Missing token. Pass --token or run promptminder auth login.No token foundSet PROMPTMINDER_TOKEN or run auth login
HTTP 401Token invalid or expiredRe-run auth login with a fresh token
Destructive commands require --yesDelete without confirmation flagAdd --yes
Use only one of --content, --content-file, or --stdinMultiple content sourcesKeep only one

Common Mistakes

  • Wrong agent wrapper syntax: promptminder-agent prompt list fails - use promptminder-agent prompt.list (dot notation).
  • Wrong team flag: --team-id does not exist - use --team <uuid>.
  • Piping with jq: pipe promptminder prompt list | jq . - stdout is always JSON.
  • Token in CI: prefer PROMPTMINDER_TOKEN env var; avoid checking in the token or running interactive auth login in pipelines.

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
113
Repository forks
56
7-day trend score
24

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 3 Oct 2026, a month ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/aircrushin/promptminder/promptminder-cli-skill/badge)](https://verified-skill.com/skills/aircrushin/promptminder/promptminder-cli-skill)

Something wrong with this skill or its page? Tell us.