PromptingCraft Guidance

com.promptingcraftPublished by promptingcraft.comOfficial publisherv0.3.0Updated Oct 29, 2026

Source-backed prompting and coding-agent guidance with provenance and freshness checks.

VerifiedStreamable HTTPWeb executableKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

Read-only remote MCP server exposing a curated, dated ledger of official prompting and coding-agent guidance, with provenance and freshness checks.

What you can do
  • Search curated guidance records by target coding agent, model family, scope and topic
  • Retrieve a single record by id, with provider, source URL, applicability, limitations, labels, verification date, snapshot hash and ledger commit
  • Check whether one allowlisted official documentation page has changed since its verified snapshot, returning unchanged, updated, unavailable or unknown
When to use it
Useful when writing or reviewing a prompt for a coding agent such as Claude Code, Codex or Cursor and you want guidance that applies to that agent and model, with a citable source and a way to see whether the source page changed since it was verified.
Requirements
A remote streamable HTTP endpoint; no account, credentials, environment variables or headers are declared. The client needs HTTPS access to the server. No local package or runtime is required.
Before you install
Read-only: the tools only list, return and compare curated records, and nothing is fetched from the web except one allowlisted page for the freshness check. The server asks callers to send only filter values and identifiers, not conversation text, code, file paths or credentials. Records labeled as PromptingCraft methodology are the vendor's own method, not provider recommendations, and a freshness check shows only that a page changed, not that guidance is correct.

Installation

In SourceWeft

  1. Open PromptingCraft Guidance in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.promptingcraft%2Fguidance/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "promptingcraft-guidance": {
      "type": "http",
      "url": "https://mcp.promptingcraft.com/mcp"
    }
  }
}

README

PromptingCraft.com

Website: promptingcraft.com

The product is publicly named PromptingCraft.com. Since 0.3.0 the skill and plugin identifier is promptingcraft (formerly promptcraft); see the migration notes.

Turn a development discussion into a prompt a fresh coding agent can execute. PromptingCraft.com preserves the task contract, consults applicable official guidance, drafts, critiques once, revises when necessary, and checks that requirements and permissions survived. The assistant writing the prompt and the agent executing it may differ. Targets: Claude Code and OpenAI Codex; Cursor is supported as a target agent (see Use in Cursor). The standalone Skill on the current source tree has version 0.4.0. Its plugin package is a separate 0.4.0 upgrade candidate; the published ChatGPT plugin remains 0.3.0, and the candidate has not been published or approved as its replacement. The existing remote guidance MCP server reports version 0.3.0; it is a separate service.

The immutable v0.1.0 tag remains the historical source release; it is not replaced by the separate ChatGPT plugin. This branch contains unreleased guidance, compatibility and package changes. The latest contract-fidelity sample found 0/14 material drift after earlier diagnostic variance; it is not a guarantee. Native Codex invocations are verified. ChatGPT-native activation and downstream superiority remain unverified. Development CI archives do not replace v0.1.0 release assets.

When the original task is already suitable, PromptingCraft.com can return: "The original prompt is already suitable. No material revision is necessary." It preserves the original text; no-change still requires contract and source checks.

It helps produce a usable handoff; it cannot supply missing access, authority, repository evidence or guarantees of downstream correctness.

Canonical source: GitLab. A public GitHub mirror is also available for browsing and installation. GitLab CI is authoritative; GitHub Actions are not enabled. Contributions may be proposed on either platform; changes are integrated through the canonical GitLab project.

Launch news

PromptingCraft.com is published in the ChatGPT Plugin Directory, and its optional guidance MCP is listed in the official MCP Registry. Both published services are version 0.3.0; the standalone Skill in the current source tree is 0.4.0. Read the launch announcement for installation, capabilities and verification details.

Two ways to use it

Use PromptingCraft as a standalone Agent Skill, or connect its MCP server for structured access to official AI-developer guidance.

Standalone Agent SkillSkill + MCP server
What you installskills/promptingcraft/ (instructions and dated references)The plugin: the same skill plus mcp.json
HostsCodex, Claude Code and Cursor (local skill folders)Hosts that load the plugin's MCP server; verified in Codex
Prompt authoring (contract, draft, critique, final, no-change)YesYes, same skill
Official guidanceBundled curated references, dated; the host's own documentation search or browsing when availableAlso search_guidance and get_guidance: records with provenance and applicability
FreshnessLive only when the host actually reads an official page in that run; otherwise labeled dated cachedcheck_source_freshness compares one official page with its verified snapshot (cached up to 15 minutes)
NetworkNone requiredHTTPS to https://mcp.promptingcraft.com/mcp (fixed categories and ids only; see privacy)
If guidance retrieval failsUses bundled references and says soSays the server was unavailable, then uses other official sources or bundled references

The MCP server is optional. It supplies evidence, not authority: the skill still extracts the contract, drafts, critiques and finalizes, and the user's requirements and permissions always win. Neither mode guarantees real-time documentation: bundled references carry their retrieval dates, and a freshness check shows only whether a page changed since it was verified. Records of kind promptingcraft_methodology are PromptingCraft.com's own method, not provider recommendations. Server details: mcp/README.md and data boundary.

A small example

Ask: "Write a Codex task: Save shows success after an API error. Preserve the API shape; don't deploy."

Draft: "Fix saving and run tests."

Critique: the draft lost the symptom, API constraint and deployment boundary.

Final:

text
Fix Save so an unsuccessful API response is not reported as success. Preservethe API shape. Locate the existing save path and verify the requested failurebehavior. Do not deploy.
Optional suggestion: use the existing error-display pattern if one is available.

This is an original illustration, not proof of improved execution. See the worked examples and evaluation protocol.

Use in ChatGPT

The PromptingCraft.com plugin bundles the skill and declares one optional remote MCP server (the guidance server, no account or credentials). Build its local source once, register the real repository root, and install through supported Codex or ChatGPT Desktop plugin controls. See the exact local installation and ChatGPT procedure. After installation, start a new chat; explicitly select PromptingCraft.com with @ or ask “Prepare a Codex prompt for this task.” It uses the established discussion and returns the final execution prompt in one copyable code block.

Current OpenAI documentation supports plugins in Chat, but local-source and account availability vary. Codex CLI installation is verified separately from ChatGPT Desktop and ordinary Chat activation. Computer Use cannot access ChatGPT in this environment; those native checks remain a documented owner-side gate. No repeated SKILL.md paste or upload is part of the supported installation route. With unavailable retrieval, source guidance remains dated/unavailable.

Install the standalone skill

From the project where you want Claude Code to use the Skill, install the current public GitHub source with the skills CLI:

sh
DISABLE_TELEMETRY=1 npx -y [email protected] add revanbcn/promptingcraft-skill --skill promptingcraft --agent claude-code --copy --yes

This installs the standalone Skill from the repository's current default branch into .claude/skills/promptingcraft/ in the project. That branch carries Skill version 0.4.0; it can change as the repository is updated. The command opts out of CLI telemetry and uses the CLI's non-interactive copy mode. Installation does not establish Skill activation or install the optional remote MCP server. To use the Skill, start a new Claude Code session and invoke /promptingcraft with your prompt-authoring request.

For the historical release, download the v0.1.0 skill archive and SHA256SUMS from GitLab v0.1.0. Verify checksums before extracting. There is no 0.2.0 release yet; a clone provides the current candidate:

sh
git clone https://gitlab.com/revanalex/promptingcraft-skill.gitcd promptingcraft-skillpython3 scripts/install_skill.py --host codex --project-dir /path/to/your/project# Or, for Claude Code:python3 scripts/install_skill.py --host claude --project-dir /path/to/your/project# Or, for Cursor:python3 scripts/install_skill.py --host cursor --project-dir /path/to/your/project

The optional installer requires Python 3.11+, refuses existing targets and touches only the explicitly chosen project's skill directory. You can instead copy the extracted promptingcraft/ directory yourself into .agents/skills/ (Codex) or .claude/skills/ (Claude Code) or .cursor/skills/ (Cursor; Cursor also reads .agents/skills/), including all its references and license. Restart the host if discovery has not refreshed. In Codex invoke $promptingcraft; in Claude Code invoke /promptingcraft, then describe the prompt you need. No development task is executed by the skill.

Use in Cursor

Cursor reads Agent Skills from .cursor/skills/ or .agents/skills/ in a project and from ~/.cursor/skills/ for the user. The plugin root (plugin.json with the Agent Plugins 1.0.0 schema and skills/promptingcraft/) follows Cursor's documented Agent Plugins format; it has not been submitted to or reviewed by the Cursor Marketplace.

When the executor is Cursor, PromptingCraft.com loads its Cursor notes: under Auto the underlying model is treated as unknown, so no Claude, GPT or Composer prompting rules are applied unless the selected model is established.

Measured in the Cursor CLI (cursor activation eval): with the default Auto setting (reported as Composer 2.5 Fast) the skill was available but did not activate automatically (0/30 prompt requests); naming it, as in “Use the promptingcraft skill to prepare a Cursor prompt for this task”, loaded it 2/2 (measured with the 0.2.0 identifier and repeated with promptingcraft). In the editor you can also pick it from the / menu. Activation depends on the selected model. Plugin loading in the Cursor editor has not been tested.

Plugin package

The plugin ZIP includes root plugin.json using Agent Plugins 1.0.0, one skills/promptingcraft/ tree, listing icons/logos under assets/ and a Claude Code compatibility manifest, plus a root mcp.json that declares the optional guidance MCP server. It declares no hooks or credentials. Its ChatGPT listing metadata (display name, descriptions, website, support, privacy and terms URLs, brand colors and icons) is checked by the validator. The existing 0.3.0 plugin is published; this 0.4.0 candidate has not been submitted for review. In Claude Code, session-only loading is:

sh
claude --plugin-dir /path/to/extracted/promptingcraft-plugin# In that session: /promptingcraft:promptingcraft

The repository already includes .agents/plugins/marketplace.json for dondego-local. Prepare its actual plugin directory before registration:

sh
python3 scripts/prepare_marketplace.pypython3 scripts/validate.py --marketplace

The generated dist/promptingcraft-plugin/ comes from the canonical skill using the existing reproducible archive builder. It is a snapshot, not a second maintained skill. The catalog resolves its path relative to the repository root. See installation, refresh and removal.

Verification and freshness

sh
python3 -m unittest discover -s tests -vpython3 scripts/validate.pypython3 scripts/package.py --output distpython3 scripts/prepare_marketplace.pypython3 scripts/validate.py --marketplace# Optional live maintenance, kept separate from merge checks:python3 scripts/freshness.py --output /tmp/promptingcraft-freshness --write-baseline

Normal checks are deterministic, offline and use synthetic documents. Live source checks compare usable normalized content hashes, use HTTP validators when supplied and discover candidate links in official indexes. They report changed, unchanged, new, missing/unavailable and partial/error states. They neither prove guidance is correct nor automatically change the skill. Fetch time is not publication time. Caches and raw model traces stay outside tracked content; reports contain metadata, not wholesale provider documentation.

See freshness operation and schedule gate, verified source decisions, actual verification and the bounded roadmap. Source guidance is revalidated during skill use when host network capabilities permit; offline notes are never current.

Scope and license

MIT licensed original content. No official OpenAI/Anthropic affiliation or endorsement. No hosted app, telemetry, sign-up, model router, API billing, marketplace submission, deployment or automatic instruction rewriting in v0.1 or the 0.2.0 candidate. See LICENSE, CONTRIBUTING, SECURITY and CHANGELOG.

Developed by the dondego.com team.

Source: README.md at commit 7c57520

Tools

3

search_guidance

Search curated guidance

List curated guidance records that match a target coding agent, model family, scope and topic. Returns official model guidance, platform documentation and Agent Skills standard records with labels, applicability and the date each source was verified. PromptingCraft.com methodology records are returned only when kind is promptingcraft_methodology and are never official provider guidance. Inputs are fixed categories only. Use get_guidance for the full record.

Parameterskindlimitscopetopicmodel_familytarget_agent

get_guidance

Get a guidance record

Return one curated record by its stable id (from search_guidance): provider, canonical source URL, applicability, limitations, labels, the date the source was verified, its snapshot hash and the ledger commit. Unknown ids return an error; nothing is fetched from the web.

Parametersidrequired

check_source_freshness

Check source freshness

Fetch one allowlisted official documentation page from the curated registry and compare its normalized text with the verified snapshot. Status is unchanged, updated, unavailable (could not be checked now) or unknown (no snapshot). Results are shared by all callers and cached for up to 15 minutes (1 minute when unavailable); live.cached and checked_at show when the page was actually fetched. When the per-source fetch limit is reached, status is unavailable with reason rate_limited. Publication and update dates are never inferred and are always null. Only registry source ids are accepted; no other URL can be requested.

Parameterssource_idrequired

Version history

1
  1. v0.3.0LatestOct 29, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts