Prompt Manager

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
}