Agent skill

Prompt Architect

by aircrushin in aircrushin/promptMinder

Design production-grade prompts with explicit task contracts, variable schemas, failure handling, and reusable quality gates.

No licenceAuto-check passedTesting & QA

Install Prompt Architect

skills CLI
$ npx skills add aircrushin/promptMinder --skill prompt-architect -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aircrushin/promptMinder prompt-architect --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aircrushin/promptMinder.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/premium/prompt-architect .claude/skills/prompt-architect && rm -rf skills-src

Use ~/.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/

Facts

Skill name
prompt-architect
GitHub stars
111
Token cost
~602 tokens
SKILL.md length
354 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
None found

At a glance

Design production-grade prompts with explicit task contracts, variable schemas, failure handling, and reusable quality gates.

  • Works in 7 steps: State the outcome in one sentence and… → Separate fixed rules from variables.… → Define the output contract before… → …
  • Tasks that involve Quality gates
  • SKILL.md covers Working contract, Method, Output format and Quality rules
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Prompt Architect is an agent skill from aircrushin/promptMinder. Design production-grade prompts with explicit task contracts, variable schemas, failure handling, and reusable quality gates.

Its SKILL.md is about 600 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 Testing & QA, covering Quality gates. The repository describes itself as: 一个开源的,专注于提示词管理的平台 / An open-source platform focused on prompt management.

When your agent uses it

  • Tasks that involve Quality gates

Example prompts

  • “/prompt-architect”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. State the outcome in one sentence and list what is explicitly out of scope.
  2. Separate fixed rules from variables. Give every variable a name, type, example, and fallback when it is missing.
  3. Define the output contract before writing the instruction. Include sections, field types, length limits, and the audience for each field.
  4. Add a decision policy for ambiguity. The agent should ask a targeted question when a missing detail could change the result; otherwise it…
  5. Add failure handling. Describe how to handle incomplete sources, conflicting requirements, unsafe requests, and tool failures.
  6. Add a quality gate with observable checks. Prefer a short checklist over vague words such as “excellent” or “high quality”.
  7. Produce a minimal test set with a normal case, an edge case, and a case that should be refused or escalated.

What it can do on your machine

Read from SKILL.md and the folder at commit 4c5134f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    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.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Prompt Architect loads about 602 tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 354 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~36
When it runs · the whole SKILL.md, loaded when a task matches
~602

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.

Safety

Auto-check passed

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.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 354 words (~602 tokens).

“Use this skill when a prompt must become a dependable workflow rather than a one-off instruction. It is designed for product teams, operators, and prompt authors who need another person to run the same prompt and get a result they…”

— opening of SKILL.md by aircrushin
name
prompt-architect

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/premium/prompt-architect of aircrushin/promptMinder.

Open the folder on GitHubat commit 4c5134f

Compare with similar skills

Prompt Architect 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.

Prompt Architect compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Prompt Architect this skillaircrushin/promptMinder111—~602Automated safety check: PassNone
Feature Plannerserendipity1004/cc-feature-implementer176—~2.4kAutomated safety check: PassNone
Ccg Workflowfengshao1227/ccg-workflow5.9k—~2.3kAutomated safety check: PassMIT
Conducty Checkpointrobertbarclayy/conducty176—~1.5kAutomated safety check: PassMIT
Mission Plannerjdforsythe/forge151—~3.5kAutomated safety check: PassMIT
Quality Gate0xNyk/lacp305—~382Automated safety check: PassMIT

Similar skills

  • Feature Planner

    serendipity1004/cc-feature-implementer

    Creates phase-based feature plans with quality gates and incremental delivery structure.

    176 GitHub stars~2.4k tokensUpdated 9 mo ago
    Testing & QAAuto-check passed
  • Ccg Workflow

    fengshao1227/ccg-workflow

    How to run a non-trivial change end to end with the CCG role tools (ccganalyze / ccgdesign / ccgbuild / ccgdebug / ccgoptimize / ccgreview / ccgtest) and the verify- quality gates.

    5.9k GitHub stars~2.3k tokensUpdated 26 days ago
    Testing & QAAuto-check passed
  • Conducty Checkpoint

    robertbarclayy/conducty

    Quality gate between parallelization groups. An agent skill from robertbarclayy/conducty.

    176 GitHub stars~1.5k tokensUpdated 3 mo ago
    Testing & QAAuto-check passed
  • Mission Planner

    jdforsythe/forge

    Decomposes goals into team blueprints using evidence-based scaling laws, topology selection, and role design.

    151 GitHub stars~3.5k tokensUpdated 3 mo ago
    Testing & QAAuto-check passed
  • Quality Gate

    0xNyk/lacp

    Production quality gate for agent sessions. An agent skill from 0xNyk/lacp.

    305 GitHub stars~382 tokensUpdated 19 days ago
    Testing & QAAuto-check passed
  • Deploy Workflow

    nwiizo/ccswarm

    Release deployment process for ccswarm. An agent skill from nwiizo/ccswarm.

    153 GitHub stars~582 tokensUpdated yesterday
    Testing & QAAuto-check passed

More from aircrushin/promptMinder

  • Promptminder CLI

    aircrushin/promptMinder

    A skill your agent uses when running promptminder or promptminder-agent commands, setting PROMPTMINDERTOKEN, passing --team for workspace scoping, handling JSON stderr errors like "Missing token" or…

    111 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Promptminder CLI

    aircrushin/promptMinder

    A skill your agent uses when running PromptMinder CLI or agent-wrapper commands, configuring its token, or debugging team-scoped JSON I/O errors.

    111 GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Agent Launch Checklist

    aircrushin/promptMinder

    Review an AI agent before release across scope, tools, state, safety, observability, human handoff, and rollback.

    111 GitHub stars~499 tokensUpdated today
    Auto-check passed
  • Content Repurposer

    aircrushin/promptMinder

    Reframe one source into channel-ready content while preserving claims, voice, disclosure requirements, and a clear review trail.

    111 GitHub stars~510 tokensUpdated today
    Auto-check passed
  • Evaluation Lab

    aircrushin/promptMinder

    Build compact, meaningful prompt evaluations with representative cases, explicit rubrics, and regression thresholds.

    111 GitHub stars~501 tokensUpdated today
    Auto-check passed

Categories

Questions about Prompt Architect

What does Prompt Architect do?

Design production-grade prompts with explicit task contracts, variable schemas, failure handling, and reusable quality gates. Prompt Architect is an agent skill from aircrushin/promptMinder. Design production-grade prompts with explicit task contracts, variable schemas, failure handling, and reusable quality gates.

When should I use Prompt Architect?

Prompt Architect fits situations like: tasks that involve Quality gates.

How do I install Prompt Architect in Claude Code?

Run `npx skills add aircrushin/promptMinder --skill prompt-architect -a claude-code`. Or copy the skill folder (skills/premium/prompt-architect in aircrushin/promptMinder) into .claude/skills/prompt-architect in your project. Claude Code loads it when a task matches its description.

How do I install Prompt Architect in Codex?

Run `npx skills add aircrushin/promptMinder --skill prompt-architect -a codex`. Or copy the skill folder (skills/premium/prompt-architect in aircrushin/promptMinder) into .agents/skills/prompt-architect in your project. Codex loads it when a task matches its description.

Can I use Prompt Architect in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aircrushin/promptMinder --skill prompt-architect -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-architect, .gemini/skills/prompt-architect, .github/skills/prompt-architect and .opencode/skills/prompt-architect in your project.

What does Prompt Architect need to run?

SKILL.md names no scripts, command-line tools or credentials: Prompt Architect is instructions for the agent only.

Does Prompt Architect access the network?

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.

Is Prompt Architect safe to install?

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.

What licence does Prompt Architect use?

No licence was found for Prompt Architect or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Prompt Architect use?

About 602 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Prompt Architect?

Skills that share tags, products or a category with Prompt Architect: Feature Planner (serendipity1004/cc-feature-implementer, 176 stars), Ccg Workflow (fengshao1227/ccg-workflow, 5.9k stars), Conducty Checkpoint (robertbarclayy/conducty, 176 stars) and Mission Planner (jdforsythe/forge, 151 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Prompt Architect?

aircrushin (a GitHub user) maintains it in aircrushin/promptMinder, which has 111 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 11, 2026.

Source: aircrushin/promptMinder on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.