Promptify Skill

Optimize prompts for clarity and effectiveness. Use when user says "improve this prompt", "optimize my prompt", "make this clearer", or provides vague/unstructured prompts. Intelligently routes to sub-agents for codebase research, clarifying questions, or web search as needed.

Security Scan

The skill's requirements and runtime instructions match its stated purpose (optimizing prompts); it is instruction-only, requests no credentials, and its web- and codebase-research behaviors are coherent with the documented modifiers.

Purpose & Capability

Name/description (prompt optimization) align with declared behavior: clarifier, codebase research, and web research sub-agents are appropriate for improving prompts that reference projects, require clarification, or need current best practices. No unrelated credentials, binaries, or config paths are requested.

Instruction Scope

SKILL.md and agent docs instruct the agent to read project files (Glob/Grep/Read) when +deep is used and to perform web searches/fetches when +web is used. This is consistent with purpose, but +deep implies file-system reads of the codebase — ensure the agent's file access is scoped to the intended project directory and that users avoid including secrets in prompts.

Install Mechanism

No install spec and no code files — instruction-only skill (lowest install risk). README suggests typical install commands for external platforms but the skill package itself contains only docs.

Credentials

The skill requires no environment variables or credentials. The documented tools (AskUserQuestion, WebSearch, WebFetch, Glob/Grep/Read) are proportional to the described functions; no unexplained secret access is requested.

Persistence & Privilege

always:false and no special persistence requested. disable-model-invocation:false (agent may invoke autonomously) is the platform default and acceptable here — not combined with broad credentials or persistent system changes.

Assessment

This skill appears coherent and does what it says: optimize prompts, ask clarifying questions, read project files when you request +deep, and search the web when you request +web. Before installing or using it, consider: (1) If you use +deep, confirm the agent's file-access scope so it doesn't read unrelated system files or secrets in the repo. (2) Web search and WebFetch will contact external sites — avoid including sensitive data in prompts that will be sent externally. (3) The skill copies optimized prompts to the clipboard (pbcopy) — clipboard contents can be read by other local apps, so avoid copying secrets. (4) Review the host agent's tool permissions (AskUserQuestion, file-read, web access) and disable +deep/+web when not needed. If you want greater assurance, request the author provide explicit bounds for file-system access and a short manifest of what the web researcher will fetch.

Prompt Optimizer

Transform prompts into clear, effective ones. Model-agnostic.

Modifiers (parse from ARGUMENTS)

• +ask → Force clarifying questions
• +deep → Force codebase exploration
• +web → Force web search

No modifiers? Auto-detect what's needed.

Auto-Detection Triggers

Trigger	Signals
codebase-researcher	"this project", "our API", specific files/functions, "integrate", "extend", "refactor"
clarifier	Ambiguous ("make it better"), multiple interpretations, missing constraints, vague pronouns
web-researcher	"best practices", "latest", external APIs/libraries, framework patterns, year references

Agent Dispatch

When agents needed:

1. Announce which and why
2. Run in parallel via Task tool (agents/ directory)
3. Synthesize findings
4. Optimize with gathered context

---

Core Contract (every prompt needs all four)

Element	If Missing
Role	Add persona with expertise
Task	Make action specific
Constraints	Infer from context
Output	Specify format/structure

Process

1. If image: Analyze, incorporate context
2. Detect type: coding/writing/analysis/creative/data
3. Convert output→process: "Write X" → "Analyze → Plan → Implement → Validate"
4. Strip fluff: "please", "I want you to", filler, apologies
5. Apply contract: Verify all 4 elements
6. Add structure: XML tags for complex prompts

Type Focus

• Coding: Specs, edge cases, framework
• Writing: Tone, audience, length
• Analysis: Criteria, depth
• Creative: Constraints, novelty
• Data: I/O format, edge cases

Output

1. Optimized prompt in code block
2. echo 'PROMPT' | pbcopy
3. 2-3 sentence explanation