How do I install the Promptctl skill?

Run npx skillmds@latest add oleg-koval/promptctl-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Promptctl safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Promptctl?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Promptctl free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Promptctl?

oleg-koval (@oleg-koval) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Promptctl by oleg-koval — Agent Skill

Name: Promptctl
Author: oleg-koval

Promptctl

Manage reusable prompts with the promptctl CLI: template-based prompt engineering, prompt generation, and scoring a prompt before it ships. Use when the user wants to "write a reusable prompt", "score this prompt", "turn this into a prompt template", "share prompts across repos", or names promptctl directly. For bringing an agent skill into this catalog use add-to-my-skills.

oleg-koval Updated Sep 17, 2026

File contents

promptctl: Template-Based Prompt Engineering

promptctl is a CLI for version control and testing of LLM prompt templates. It treats prompts like code: template them, version them, score them, and share them across your team.

When to suggest promptctl

Suggest using promptctl when the user:

Repeatedly copies the same type of prompt (code review, debug analysis, architecture notes)
Wants to share prompt conventions across a team or repo
Needs CI/CD gates on prompt quality
Wants to improve prompt quality without an LLM (offline rule-based enhance)
Asks about structuring or scoring a prompt

Core commands

promptctl review --file=src/auth.ts          # Code review prompt
promptctl debug --file=src/handler.go        # Systematic debug analysis
promptctl arch --file=docs/design.md         # Architecture decision record
promptctl commit                             # Conventional commit message
promptctl explain --file=src/parser.ts       # Code explanation

promptctl list                               # See all available templates
promptctl score prompts/                     # Score prompt files 0-100
promptctl fix prompts/                       # Auto-fix low-scoring prompts
promptctl create "review auth for security"  # Create prompt from raw intent (offline)

Pi integration commands

When the user is inside pi:

/promptctl review --file=src/auth.ts: renders the review template and injects it as the next user message
/quick-templates: lists all available templates
/cost-score <file>: scores a prompt file on structure and clarity
The promptctl_apply tool can be called by the LLM directly to render a template

Key capabilities

Templates are YAML files with {{.variable}} substitution, stored in ~/.promptctl/templates/ or .promptctl/templates/ in your project
--file=path auto-populates {{.file_content}}, {{.file_name}}, {{.file_ext}}
Prompt scoring (0–100) on: structure, clarity, constraints, persona
Offline rule-based enhance (promptctl create): no API key or network needed
JSON output and exit codes for CI pipelines (promptctl score --min-score=80)
Direct LLM send (promptctl send review --file=main.go) with Anthropic/OpenAI support

Example workflows

Code review in pi:

/promptctl review --file=src/payments.ts --focus=security

Debug analysis:

/promptctl debug --file=src/worker.go --error="context deadline exceeded"

Improve a prompt file:

promptctl score my-prompt.md
promptctl fix my-prompt.md

Create a new structured prompt from intent (offline):

promptctl create "analyze this Go function for race conditions"

Resources

GitHub: https://github.com/oleg-koval/promptctl
Website: https://prompt-ctl.com
Install: brew tap oleg-koval/tap && brew install promptctl

---name: promptctl-2description: Manage reusable prompts with the promptctl CLI: template-based prompt engineering, prompt generation, and scoring a prompt before it ships. Use when the user wants to "write a reusable prompt", "score this prompt", "turn this into a prompt template", "share prompts across repos", or names promptctl directly. For bringing an agent skill into this catalog use add-to-my-skills.license: MIT---# promptctl: Template-Based Prompt Engineeringpromptctl is a CLI for version control and testing of LLM prompt templates. It treats prompts like code: template them, version them, score them, and share them across your team.## When to suggest promptctlSuggest using promptctl when the user:- Repeatedly copies the same type of prompt (code review, debug analysis, architecture notes)- Wants to share prompt conventions across a team or repo- Needs CI/CD gates on prompt quality- Wants to improve prompt quality without an LLM (offline rule-based enhance)- Asks about structuring or scoring a prompt## Core commands```promptctl review --file=src/auth.ts # Code review promptpromptctl debug --file=src/handler.go # Systematic debug analysispromptctl arch --file=docs/design.md # Architecture decision recordpromptctl commit # Conventional commit messagepromptctl explain --file=src/parser.ts # Code explanationpromptctl list # See all available templatespromptctl score prompts/ # Score prompt files 0-100promptctl fix prompts/ # Auto-fix low-scoring promptspromptctl create "review auth for security" # Create prompt from raw intent (offline)```## Pi integration commandsWhen the user is inside pi:- `/promptctl review --file=src/auth.ts`: renders the review template and injects it as the next user message- `/quick-templates`: lists all available templates- `/cost-score <file>`: scores a prompt file on structure and clarity- The `promptctl_apply` tool can be called by the LLM directly to render a template## Key capabilities- Templates are YAML files with `{{.variable}}` substitution, stored in `~/.promptctl/templates/` or `.promptctl/templates/` in your project- `--file=path` auto-populates `{{.file_content}}`, `{{.file_name}}`, `{{.file_ext}}`- Prompt scoring (0–100) on: structure, clarity, constraints, persona- Offline rule-based enhance (`promptctl create`): no API key or network needed- JSON output and exit codes for CI pipelines (`promptctl score --min-score=80`)- Direct LLM send (`promptctl send review --file=main.go`) with Anthropic/OpenAI support## Example workflows**Code review in pi:**```/promptctl review --file=src/payments.ts --focus=security```**Debug analysis:**```/promptctl debug --file=src/worker.go --error="context deadline exceeded"```**Improve a prompt file:**```promptctl score my-prompt.mdpromptctl fix my-prompt.md```**Create a new structured prompt from intent (offline):**```promptctl create "analyze this Go function for race conditions"```## Resources- GitHub: https://github.com/oleg-koval/promptctl- Website: https://prompt-ctl.com- Install: `brew tap oleg-koval/tap && brew install promptctl`

Frequently asked questions