Agent skill

prompt-manager

View SKILL.md on GitHub Repository
Stars 6
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/cruzanstx/daplug/tree/main/skills/prompt-manager

SKILL.md

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

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

Commands

Get Next Number

bash
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

bash
# 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

bash
# 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

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

Create Prompt

bash
# 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/)

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

Delete Prompt

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

Get Directory Info

bash
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

bash
# 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

bash
# 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:

bash
$ 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

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

Info

json
{
  "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
}

Didn't find tool you were looking for?

Be as detailed as possible for better results