Prompt File Finder Skill

Prompt File Finder

Locate and resolve prompt files using the prompt-manager skill.

Setup

All operations use prompt-manager for consistent git root detection:

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

When to Use This Skill

User asks "find prompt 42" or "which prompt is about auth?"
User wants to "list available prompts" or "show prompts"
User asks "what's the latest prompt?" or "most recent prompt"
Before executing a prompt, to resolve the exact file path
User wants to search prompts by keyword

Core Operations

List All Prompts

# List all prompts (active and completed)
python3 "$PROMPT_MANAGER" list

# Output:
# [ ] 006 - backup-server
# [ ] 007 - deploy-k8s
# [✓] 001 - initial-setup
# [✓] 002 - add-authentication

# 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 42
# Output: /path/to/repo/prompts/042-my-prompt.md

# As JSON with full info
python3 "$PROMPT_MANAGER" find 42 --json
# {
#   "number": "042",
#   "name": "my-prompt",
#   "filename": "042-my-prompt.md",
#   "path": "/path/to/repo/prompts/042-my-prompt.md",
#   "status": "active"
# }

Read Prompt Content

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

Show Prompt Preview

# Read first 30 lines
python3 "$PROMPT_MANAGER" read 42 | head -30

Get Prompts Directory Info

python3 "$PROMPT_MANAGER" info
# Repository root: /path/to/repo
# Prompts directory: /path/to/repo/prompts
# Completed directory: /path/to/repo/prompts/completed
# Next number: 008
# Active prompts: 2
# Completed prompts: 5
# Total prompts: 7

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

Find Prompt by Name/Keyword

# List all and grep for keyword
python3 "$PROMPT_MANAGER" list | grep -i "auth"

# Or use JSON and jq
python3 "$PROMPT_MANAGER" list --json | jq '.[] | select(.name | contains("auth"))'

Search Prompt Contents

For content search, use Grep tool on the prompts directory:

# Get prompts directory
PROMPTS_DIR=$(python3 "$PROMPT_MANAGER" info --json | jq -r '.prompts_dir')

# Search contents
grep -l -i "database" "$PROMPTS_DIR"/*.md 2>/dev/null

Or use the Grep tool:

Grep pattern="database" path="{prompts_dir}" glob="*.md"

Archive/Complete a Prompt

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

Resolution Examples

# Find prompt 6 (auto-pads to 006)
PROMPT_PATH=$(python3 "$PROMPT_MANAGER" find 6)
if [ -n "$PROMPT_PATH" ]; then
    echo "Found: $PROMPT_PATH"
    # Read content
    CONTENT=$(python3 "$PROMPT_MANAGER" read 6)
fi

# Check if prompt exists
if python3 "$PROMPT_MANAGER" find 99 >/dev/null 2>&1; then
    echo "Prompt 99 exists"
else
    echo "Prompt 99 not found"
fi

Error Handling

prompt-manager returns exit code 1 and writes errors to stderr:

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

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

Expected Directory Structure

{git_root}/prompts/
├── 006-backup-server.md
├── 007-deploy-k8s.md
├── ...
└── completed/
    ├── 001-initial-setup.md
    ├── 002-add-authentication.md
    └── ...

Naming Convention

Prompts follow the pattern: NNN-descriptive-name.md

NNN = Zero-padded number (001, 042, 123)
descriptive-name = Kebab-case description (max 5 words)
.md = Markdown extension

Legacy Compatibility

If prompt-manager is not available, fall back to direct file operations:

# Check if prompt-manager exists
if [ ! -f "$PROMPT_MANAGER" ]; then
    # Fallback: direct file listing
    ls -1 ./prompts/*.md 2>/dev/null
fi

Agent Skills: Prompt File Finder

Skill Files