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
}

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

cruzanstx/daplug

at-prompt-runner

Orchestrate multi-prompt execution with phase groups, optional auto-deps, and model-tiered agent roles.

6 0
Explore
cruzanstx/daplug

prompt-finder

Find and resolve prompt files in ./prompts/ directory. Use when user asks to find a prompt, list available prompts, locate prompt by number or name, or check what prompts exist.

6 0
Explore
cruzanstx/daplug

at-prompt-creator

Create agent-team orchestrated prompt bundles (orchestrator + sub-prompts) and store them through prompt-manager.

6 0
Explore
cruzanstx/daplug

cli-detector

Detect installed AI coding CLIs and local model providers; outputs a cached JSON inventory for routing (/detect-clis).

6 0
Explore
cruzanstx/daplug

prompt-executor

Execute prompts from ./prompts/ directory with various AI models. Use when user asks to run a prompt, execute a task, delegate work to an AI model, run prompts in worktrees/tmux, or run prompts with verification loops.

6 0
Explore
cruzanstx/daplug

ai-usage

Check AI CLI usage/quota for Claude Code, OpenAI Codex, Google Gemini CLI, and Z.AI. Use when user asks about remaining quota, usage limits, rate limits, or wants to check how much capacity is left.

6 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results