prompt-manager

CRUD operations for prompt files. Centralizes all prompt management logic to avoid shell parsing issues and provide consistent behavior across commands.

Description

Manages prompt files in {repo_root}/prompts/ with support for:

• Listing active and completed prompts
• Organizing active prompts in subfolders under prompts/ (e.g. prompts/providers/)
• Getting the next available number
• Creating new prompts
• Moving prompts to completed
• Deleting prompts
• Reading prompt content

Triggers

Use this skill when you need to:

• Find the next prompt number
• List existing prompts
• Create a new prompt file
• Move a prompt to completed
• Delete a prompt
• Read prompt content by number

Tool Requirements

tools:
  - Bash(python3:*)
  - Bash(PROMPT_MANAGER=:*)

Commands

Get Next Number

PROMPT_MANAGER=$(jq -r '.plugins."daplug@cruzanstx"[0].installPath' ~/.claude/plugins/installed_plugins.json)/skills/prompt-manager/scripts/manager.py
python3 "$PROMPT_MANAGER" next-number

Output: 006 (next available 3-digit number)

List Prompts

# List all prompts
python3 "$PROMPT_MANAGER" list

# Filter to a folder under prompts/ (excludes completed/ by default)
python3 "$PROMPT_MANAGER" list --folder providers

# Tree view
python3 "$PROMPT_MANAGER" list --tree

# List as JSON
python3 "$PROMPT_MANAGER" list --json

# Active only
python3 "$PROMPT_MANAGER" list --active

# Completed only
python3 "$PROMPT_MANAGER" list --completed

Find Prompt by Number

# Returns path to prompt file
python3 "$PROMPT_MANAGER" find 6
# Output: /path/to/repo/prompts/006-my-prompt.md

# Folder-qualified lookup
python3 "$PROMPT_MANAGER" find providers/6
# Output: /path/to/repo/prompts/providers/006-my-prompt.md

# Name search across folders
python3 "$PROMPT_MANAGER" find "backup-server"

# As JSON
python3 "$PROMPT_MANAGER" find 6 --json

Read Prompt Content

python3 "$PROMPT_MANAGER" read 6
# Outputs the full content of the prompt

Create Prompt

# From content argument
python3 "$PROMPT_MANAGER" create "backup-server" --content "Prompt content here"

# Into a subfolder (folder is relative to prompts/; completed/ is reserved)
python3 "$PROMPT_MANAGER" create "github-copilot-integration" --folder providers --content "..."

# From file
python3 "$PROMPT_MANAGER" create "backup-server" --content-file /tmp/prompt.md

# From stdin
cat prompt.md | python3 "$PROMPT_MANAGER" create "backup-server"

# With specific number
python3 "$PROMPT_MANAGER" create "backup-server" --number 010 --content "..."

# JSON output
python3 "$PROMPT_MANAGER" create "backup-server" --content "..." --json

Complete Prompt (Move to completed/)

python3 "$PROMPT_MANAGER" complete 6
# Output: Completed: /path/to/repo/prompts/completed/006-my-prompt.md

Delete Prompt

python3 "$PROMPT_MANAGER" delete 6
# Output: Deleted: 006-my-prompt.md

Get Directory Info

python3 "$PROMPT_MANAGER" info

# Output:
# Repository root: /path/to/repo
# Prompts directory: /path/to/repo/prompts
# Completed directory: /path/to/repo/prompts/completed
# Next number: 006
# Active prompts: 2
# Completed prompts: 5
# Total prompts: 7

# As JSON
python3 "$PROMPT_MANAGER" info --json

Integration Examples

From /create-prompt

# Get plugin path
PLUGIN_ROOT=$(jq -r '.plugins."daplug@cruzanstx"[0].installPath' ~/.claude/plugins/installed_plugins.json)
PROMPT_MANAGER="$PLUGIN_ROOT/skills/prompt-manager/scripts/manager.py"

# Get next number
NEXT_NUM=$(python3 "$PROMPT_MANAGER" next-number)
echo "Next prompt will be: $NEXT_NUM"

# Create the prompt
python3 "$PROMPT_MANAGER" create "my-task-name" --content "$PROMPT_CONTENT" --json

From /run-prompt

# Find prompt path
PROMPT_PATH=$(python3 "$PROMPT_MANAGER" find 6)
if [ -z "$PROMPT_PATH" ]; then
    echo "Prompt 6 not found"
    exit 1
fi

# Read content
CONTENT=$(python3 "$PROMPT_MANAGER" read 6)

Error Handling

All errors are written to stderr with exit code 1:

$ python3 "$PROMPT_MANAGER" find 999
Error: Prompt 999 not found

$ python3 "$PROMPT_MANAGER" complete 6  # already completed
Error: Prompt 006 is already completed

$ python3 "$PROMPT_MANAGER" create "test" --number 5  # exists
Error: Prompt 005 already exists: /path/to/prompts/005-test.md

JSON Output Schema

PromptInfo

{
  "number": "006",
  "name": "backup-server",
  "filename": "006-backup-server.md",
  "path": "/path/to/repo/prompts/006-backup-server.md",
  "status": "active",
  "folder": ""
}

Info

{
  "repo_root": "/path/to/repo",
  "prompts_dir": "/path/to/repo/prompts",
  "completed_dir": "/path/to/repo/prompts/completed",
  "next_number": "007",
  "active_count": 2,
  "completed_count": 5,
  "total_count": 7
}