Prompt Improver
severity1/claude-code-prompt-improver
This skill enriches vague prompts with targeted research and clarification before execution.
Create or improve Agent Deck/Pi prompt templates for reusable parent-session workflows.
$ npx skills add a-streetcoder/agent-deck --skill prompt-authoring -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install a-streetcoder/agent-deck prompt-authoring --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/a-streetcoder/agent-deck.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agent-deck/bundled-skills/prompt-authoring .claude/skills/prompt-authoring && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "prompt-authoring" agent skill from https://github.com/a-streetcoder/agent-deck/tree/main/agent-deck/bundled-skills/prompt-authoring into .claude/skills/prompt-authoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prompt-authoring", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/a-streetcoder/agent-deck/tree/main/agent-deck/bundled-skills/prompt-authoringType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add a-streetcoder/agent-deck --skill prompt-authoring -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install a-streetcoder/agent-deck prompt-authoring --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/a-streetcoder/agent-deck.git skills-src && mkdir -p .agents/skills && cp -r skills-src/agent-deck/bundled-skills/prompt-authoring .agents/skills/prompt-authoring && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "prompt-authoring" agent skill from https://github.com/a-streetcoder/agent-deck/tree/main/agent-deck/bundled-skills/prompt-authoring into .agents/skills/prompt-authoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prompt-authoring", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add a-streetcoder/agent-deck --skill prompt-authoring -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install a-streetcoder/agent-deck prompt-authoring --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/a-streetcoder/agent-deck.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/agent-deck/bundled-skills/prompt-authoring .cursor/skills/prompt-authoring && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "prompt-authoring" agent skill from https://github.com/a-streetcoder/agent-deck/tree/main/agent-deck/bundled-skills/prompt-authoring into .cursor/skills/prompt-authoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prompt-authoring", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/a-streetcoder/agent-deck.git --path agent-deck/bundled-skills/prompt-authoring--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add a-streetcoder/agent-deck --skill prompt-authoring -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install a-streetcoder/agent-deck prompt-authoring --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/a-streetcoder/agent-deck.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/agent-deck/bundled-skills/prompt-authoring .gemini/skills/prompt-authoring && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "prompt-authoring" agent skill from https://github.com/a-streetcoder/agent-deck/tree/main/agent-deck/bundled-skills/prompt-authoring into .gemini/skills/prompt-authoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prompt-authoring", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install a-streetcoder/agent-deck prompt-authoringInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add a-streetcoder/agent-deck --skill prompt-authoring -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/a-streetcoder/agent-deck.git skills-src && mkdir -p .github/skills && cp -r skills-src/agent-deck/bundled-skills/prompt-authoring .github/skills/prompt-authoring && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "prompt-authoring" agent skill from https://github.com/a-streetcoder/agent-deck/tree/main/agent-deck/bundled-skills/prompt-authoring into .github/skills/prompt-authoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prompt-authoring", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add a-streetcoder/agent-deck --skill prompt-authoring -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install a-streetcoder/agent-deck prompt-authoring --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/a-streetcoder/agent-deck.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/agent-deck/bundled-skills/prompt-authoring .opencode/skills/prompt-authoring && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "prompt-authoring" agent skill from https://github.com/a-streetcoder/agent-deck/tree/main/agent-deck/bundled-skills/prompt-authoring into .opencode/skills/prompt-authoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prompt-authoring", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
prompt-authoringCreate or improve Agent Deck/Pi prompt templates for reusable parent-session workflows.
Prompt Authoring is an agent skill from a-streetcoder/agent-deck. Create or improve Agent Deck/Pi prompt templates for reusable parent-session workflows.
Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in AI & LLM Engineering, covering Prompt engineering. The licence is MIT.
6 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 9efbe6c. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Prompt Authoring loads about 721 tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 282 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from a-streetcoder/agent-deck at commit 9efbe6c, republished under its MIT licence (© a-streetcoder). 282 words, ~721 tokens.
.claude/skills/prompt-authoring/SKILL.md (or your agent's skills folder).Use this skill when the user wants a reusable slash prompt, workflow shortcut, or global/imported prompt template for parent Pi Agent sessions.
/name in a parent Pi session.review-staged.md becomes /review-staged.--no-prompt-templates and pass only assigned templates with explicit --prompt-template <path> flags.Create reusable catalog prompts in Agent Deck's prompt library unless the user asks to keep an existing file elsewhere and import it by reference through Agent Deck’s + flow:
~/.pi/agent/prompt-library/<name>.mdAgent Deck no longer discovers project-local .pi/prompts or project settings prompts/package prompt sources as catalog resources. Global/default and project availability are Agent Deck assignments. Do not rely on ambient Pi prompt discovery. Import is by reference, not a copy.
Use Markdown with optional frontmatter:
---
description: Short autocomplete description
argument-hint: "[optional-focus]"
---
Prompt body here.Rules:
argument-hint only when arguments are expected.argument-hint and do not include placeholders.Supported placeholders:
$1, $2, ... positional arguments
$@ all arguments joined
$ARGUMENTS all arguments joined
${@:N} arguments from N onward, 1-indexed
${@:N:L} L arguments starting at NExamples:
---
description: Review a target with an optional focus
argument-hint: "<target> [focus]"
---
Review $1.
Focus on: ${@:2}No-argument template:
---
description: Review staged git changes
---
Review the staged git changes with `git diff --cached`.
Focus on:
- bugs
- regressions
- missing tests© a-streetcoder, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in agent-deck/bundled-skills/prompt-authoring of a-streetcoder/agent-deck.
Open the folder on GitHubat commit 9efbe6c
Prompt Authoring next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Prompt Authoring this skilla-streetcoder/agent-deck | 118 | — | ~721 | Automated safety check: Pass | MIT | |
| Prompt Improverseverity1/claude-code-prompt-improver | 1.9k | 1 repos | ~1.7k | Automated safety check: Pass | MIT | |
| Prompt Engineering Patternsynulihao/AgentSkillOS | 617 | 14 repos | ~1.7k | Automated safety check: Pass | None | |
| Patch CreationPiebald-AI/tweakcc | 2.5k | — | ~1.6k | Automated safety check: Pass | MIT | |
| Senior Prompt Engineermaslennikov-ig/claude-code-orchestrator-kit | 260 | 3 repos | ~1.4k | Automated safety check: Pass | Custom licence | |
| Codex Fable5baskduf/FableCodex | 437 | — | ~1.6k | Automated safety check: Pass | AGPL-3.0 |
severity1/claude-code-prompt-improver
This skill enriches vague prompts with targeted research and clarification before execution.
ynulihao/AgentSkillOS
Master advanced prompt engineering techniques to maximize LLM performance, reliability, and controllability in production.
Piebald-AI/tweakcc
Create and register new patches for tweakcc. An agent skill from Piebald-AI/tweakcc.
maslennikov-ig/claude-code-orchestrator-kit
Provides reference guides and Python scripts for prompt optimization, RAG evaluation, and agent orchestration when building or tuning LLM systems.
baskduf/FableCodex
Apply a Claude Fable 5 inspired operating style inside Codex.
wshobson/agents
Reference for designing and tuning production LLM prompts: few-shot examples, chain-of-thought, structured outputs, templates and system prompts.
a-streetcoder/agent-deck
A skill your agent uses when creating or reviewing Agent Deck agents, including frontmatter, tools, supervisor behavior, continuation behavior, and skill assignment.
a-streetcoder/agent-deck
A skill your agent uses when helping users install, import, repair, or verify MCP server configurations in Agent Deck.
a-streetcoder/agent-deck
A skill your agent uses when creating, refining, or validating Agent Deck loops, especially to guide users iteratively through loop goal, structure, agents, write target, and safety choices.
a-streetcoder/agent-deck
Create or improve Agent Deck/Pi skills, including where to save them, SKILL.md frontmatter, simple vs modular structure, and validation.
Categories
Create or improve Agent Deck/Pi prompt templates for reusable parent-session workflows. Prompt Authoring is an agent skill from a-streetcoder/agent-deck. Create or improve Agent Deck/Pi prompt templates for reusable parent-session workflows.
Prompt Authoring fits situations like: tasks that involve Prompt engineering.
Run `npx skills add a-streetcoder/agent-deck --skill prompt-authoring -a claude-code`. Or copy the skill folder (agent-deck/bundled-skills/prompt-authoring in a-streetcoder/agent-deck) into .claude/skills/prompt-authoring in your project. Claude Code loads it when a task matches its description.
Run `npx skills add a-streetcoder/agent-deck --skill prompt-authoring -a codex`. Or copy the skill folder (agent-deck/bundled-skills/prompt-authoring in a-streetcoder/agent-deck) into .agents/skills/prompt-authoring in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add a-streetcoder/agent-deck --skill prompt-authoring -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/prompt-authoring, .gemini/skills/prompt-authoring, .github/skills/prompt-authoring and .opencode/skills/prompt-authoring in your project.
SKILL.md names no scripts, command-line tools or credentials: Prompt Authoring is instructions for the agent only.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Prompt Authoring is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 721 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Prompt Authoring: Prompt Improver (severity1/claude-code-prompt-improver, 1.9k stars), Prompt Engineering Patterns (ynulihao/AgentSkillOS, 617 stars), Patch Creation (Piebald-AI/tweakcc, 2.5k stars) and Senior Prompt Engineer (maslennikov-ig/claude-code-orchestrator-kit, 260 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
a-streetcoder (a GitHub organization) maintains it in a-streetcoder/agent-deck, which has 118 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on August 1, 2026.
Source: a-streetcoder/agent-deck on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.