{"id":50608404,"url":"https://github.com/phalves23/prompt-engineering-skill","last_synced_at":"2026-06-12T07:00:58.529Z","repository":{"id":362782517,"uuid":"1260764761","full_name":"PhAlves23/prompt-engineering-skill","owner":"PhAlves23","description":"Prompt Engineering skill for Claude Code — rewrites and optimizes prompts using proven techniques (Anthropic, OpenAI, Gemini, The Prompt Report).","archived":false,"fork":false,"pushed_at":"2026-06-05T23:39:15.000Z","size":835,"stargazers_count":4,"open_issues_count":2,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-07T02:02:58.937Z","etag":null,"topics":["ai","claude","claude-code","claude-code-plugin","claude-skill","copilot","cursor","gemini","llm","openai","prompt-engineering","prompts"],"latest_commit_sha":null,"homepage":"https://promptcause.com/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PhAlves23.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["PhAlves23"]}},"created_at":"2026-06-05T21:07:59.000Z","updated_at":"2026-06-06T16:14:12.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/PhAlves23/prompt-engineering-skill","commit_stats":null,"previous_names":["phalves23/prompt-engineering-skill"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/PhAlves23/prompt-engineering-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PhAlves23%2Fprompt-engineering-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PhAlves23%2Fprompt-engineering-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PhAlves23%2Fprompt-engineering-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PhAlves23%2Fprompt-engineering-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PhAlves23","download_url":"https://codeload.github.com/PhAlves23/prompt-engineering-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PhAlves23%2Fprompt-engineering-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34046003,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-08T02:00:07.615Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","claude","claude-code","claude-code-plugin","claude-skill","copilot","cursor","gemini","llm","openai","prompt-engineering","prompts"],"created_at":"2026-06-06T01:02:25.661Z","updated_at":"2026-06-09T04:01:15.080Z","avatar_url":"https://github.com/PhAlves23.png","language":"HTML","funding_links":["https://github.com/sponsors/PhAlves23"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"assets/banner.png\" alt=\"Prompt Engineering — an AI skill that turns a raw draft into a production-grade prompt\" width=\"100%\"\u003e\n\n\u003cbr\u003e\u003cbr\u003e\n\n**An AI skill that turns a raw draft into a production-grade prompt.**\n\nIt rewrites and optimizes prompts using proven techniques, then hands you a ready-to-paste result plus a short changelog of what changed and why — calibrated to your task type and target model.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Validate](https://github.com/PhAlves23/prompt-engineering-skill/actions/workflows/validate.yml/badge.svg)](https://github.com/PhAlves23/prompt-engineering-skill/actions/workflows/validate.yml)\n[![Version](https://img.shields.io/badge/version-1.1.0-green.svg)](https://github.com/PhAlves23/prompt-engineering-skill/releases)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)\n\nWorks with **Claude Code · GitHub Copilot · OpenAI Codex · Gemini CLI · OpenCode · Cursor · Windsurf · Cline**\n\n\u003c/div\u003e\n\n---\n\n## Table of contents\n\n- [Why this skill](#why-this-skill)\n- [How it works](#how-it-works)\n- [Example](#example)\n- [Installation](#installation)\n- [Verify installation](#verify-installation)\n- [Usage](#usage)\n- [What's inside](#whats-inside)\n- [Updating](#updating)\n- [Uninstall](#uninstall)\n- [Contributing](#contributing)\n- [Project structure](#project-structure)\n- [License](#license)\n\n---\n\n## Why this skill\n\nMost prompt advice is a handful of generic tips. This skill is different in three ways:\n\n- **Grounded in primary sources.** Every technique is traceable to a cited source — Anthropic's prompting best practices and prompt improver, OpenAI's GPT-5/reasoning guides, Google's Gemini PTCF, and *The Prompt Report*'s academic taxonomy of 58 techniques. See [`sources.md`](plugins/prompt-engineering/skills/prompt-engineering/references/sources.md).\n- **Model-aware.** The rules differ by model family. The skill adapts to Claude 4.x, OpenAI GPT/reasoning (o-series), and Gemini — e.g. it removes \"think step by step\" for reasoning models, which actively hurts them.\n- **Anti-overengineering.** It calibrates effort to complexity. A simple prompt gets a lean rewrite; it won't bloat it with chain-of-thought and examples it doesn't need.\n\n\u003e It **improves the prompt** — it does not run it, unless you explicitly ask.\n\n## How it works\n\nYou paste a draft (or describe what you want). The skill runs a five-phase workflow:\n\n1. **Diagnose** — real intent, task type, target model, audience, output format, constraints, and the draft's weaknesses.\n2. **Select techniques** — only those that add value for this task and model.\n3. **Rewrite** — assemble the prompt in a canonical structure (role, context+motivation, XML-tagged data, positive instructions, few-shot, output contract).\n4. **Self-review** — run a quality checklist; the golden test is \"could a colleague with no context run this without doubt?\"\n5. **Deliver** — the optimized prompt + a changelog mapping each change to the weakness it fixes.\n\n## Example\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003cth\u003eYour draft (before)\u003c/th\u003e\n\u003cth\u003eAfter the skill\u003c/th\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd valign=\"top\"\u003e\n\n```\nclassify the sentiment\nof this comment:\n{{comment}}\n```\n\n\u003c/td\u003e\n\u003ctd valign=\"top\"\u003e\n\n```\nYou are a sentiment analyst\nspecialized in customer feedback.\n\nClassify the sentiment of the comment\nbelow into one of these categories:\npositive, negative, neutral.\n\n\u003ccomment\u003e\n{{comment}}\n\u003c/comment\u003e\n\nFollow these steps:\n1. Identify expressions that carry emotion.\n2. Weigh the overall tone, accounting\n   for irony and negation.\n3. Choose the predominant sentiment.\n\nPut your reasoning in \u003canalysis\u003e. On the\nlast line, answer ONLY one word:\npositive, negative, or neutral.\n```\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n**What the skill changed, and why:** added a **role** (calibrates interpretation), a strict **enum output contract** (`ONLY one word` — parseable), a short **chain-of-thought** (catches irony/negation, the top error source in sentiment), and **XML** around the input (robust to comments with line breaks). Every rewrite ships with this changelog.\n\nSee six more cases — coding, extraction, research, agentic, long-context, and an already-good prompt — in [`worked-examples.md`](plugins/prompt-engineering/skills/prompt-engineering/references/worked-examples.md).\n\n## Installation\n\nPick your tool. Claude Code is the primary target; the rest are fully supported.\n\n\u003cdetails open\u003e\n\u003csummary\u003e\u003cb\u003eClaude Code\u003c/b\u003e\u003c/summary\u003e\n\n**One-line installer** (copies the skill into `~/.claude/skills/`, backs up any existing install, touches nothing else):\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/PhAlves23/prompt-engineering-skill/main/install.sh | bash\n```\n\n**Or as a plugin** (versioned, updatable):\n\n```\n/plugin marketplace add PhAlves23/prompt-engineering-skill\n/plugin install prompt-engineering\n```\n\nRestart Claude Code after installing.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eGitHub Copilot CLI\u003c/b\u003e\u003c/summary\u003e\n\nThe plugin marketplace works in Copilot CLI too:\n\n```bash\ncopilot plugin marketplace add PhAlves23/prompt-engineering-skill\ncopilot plugin install prompt-engineering@prompt-engineering-marketplace\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eOpenAI Codex\u003c/b\u003e\u003c/summary\u003e\n\nCodex discovers the full skill from `~/.agents/skills/`. Full guide: [`docs/INSTALL.codex.md`](docs/INSTALL.codex.md).\n\n```bash\ngit clone https://github.com/PhAlves23/prompt-engineering-skill.git ~/.codex/prompt-engineering-skill\nmkdir -p ~/.agents/skills\nln -s ~/.codex/prompt-engineering-skill/plugins/prompt-engineering/skills/prompt-engineering ~/.agents/skills/prompt-engineering\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eGemini CLI\u003c/b\u003e\u003c/summary\u003e\n\n```bash\ngemini extensions install https://github.com/PhAlves23/prompt-engineering-skill\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eOpenCode\u003c/b\u003e\u003c/summary\u003e\n\nReads `AGENTS.md` natively. Quickest path (full guide: [`docs/INSTALL.opencode.md`](docs/INSTALL.opencode.md)):\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/PhAlves23/prompt-engineering-skill/main/adapters/codex/AGENTS.md -o AGENTS.md\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eCursor / Windsurf / Cline\u003c/b\u003e\u003c/summary\u003e\n\nCopy the rule for your tool from [`adapters/`](adapters/):\n\n- **Cursor** → `adapters/cursor/.cursor/rules/prompt-engineering.mdc` into your project's `.cursor/rules/` (invoke with `@prompt-engineering`). A native Cursor plugin manifest is also provided at `.cursor-plugin/plugin.json`.\n- **Windsurf** → `adapters/windsurf/.windsurf/rules/prompt-engineering.md` into `.windsurf/rules/` (activates by intent).\n- **Cline** → `adapters/cline/.clinerules/prompt-engineering.md` into `.clinerules/prompt-engineering.md` (workspace rule; ask explicitly).\n\nSee [`adapters/README.md`](adapters/README.md) for details and other tools (Roo, Continue, Zed).\n\u003c/details\u003e\n\n## Verify installation\n\nStart a new session and ask for something that should trigger the skill — for example, paste a draft with \"improve this prompt\", or run `/prompt-engineering` in Claude Code. You should get an optimized prompt + a changelog.\n\n```bash\n# Claude Code / curl install:\ntest -f ~/.claude/skills/prompt-engineering/SKILL.md \u0026\u0026 echo \"installed\" || echo \"not found\"\n```\n\n## Usage\n\nType `/prompt-engineering` (Claude Code / Copilot), or simply say:\n\n- \"improve this prompt\"\n- \"optimize this prompt\"\n- \"rewrite this prompt\"\n- or paste a draft and ask to make it better.\n\nThe skill activates automatically (where the tool supports intent-based activation) and returns the rewritten prompt plus a changelog.\n\n## What's inside\n\n| Component | What it gives you |\n|-----------|-------------------|\n| **Canonical structure** | Role, context+motivation, sequential instructions, XML, few-shot, CoT, output contract, success criteria |\n| **Technique selection** | By task type (classification, extraction, generation, coding, reasoning, research, agentic, summarization) and model |\n| **Technique index** | All 58 techniques from *The Prompt Report* plus vendor/post-2024 extras |\n| **Worked examples** | 7 full draft → optimized → changelog cases |\n| **Quality checklist** | Pre-delivery self-review |\n| **Evaluation guide** | How to A/B test that the rewrite is actually better |\n| **Prompt security** | Defenses against injection/jailbreak |\n| **Auto-optimization** | APE, OPRO, DSPy, MIPRO references for when you have an eval set |\n\n## Updating\n\n| Install method | Update command |\n|----------------|----------------|\n| curl installer | re-run the installer |\n| Claude / Copilot plugin | `/plugin update prompt-engineering` |\n| Codex symlink | `cd ~/.codex/prompt-engineering-skill \u0026\u0026 git pull` |\n| Gemini extension | `gemini extensions update prompt-engineering` |\n\n## Uninstall\n\n- curl / manual: `rm -rf ~/.claude/skills/prompt-engineering`\n- Claude plugin: `/plugin uninstall prompt-engineering`\n- Codex: `rm ~/.agents/skills/prompt-engineering`\n\n## Contributing\n\nIssues and pull requests are welcome. Start with [CONTRIBUTING.md](CONTRIBUTING.md) — it covers the dev setup, how the adapters are generated from a single source, and the review process. Please also read the [Code of Conduct](CODE_OF_CONDUCT.md). Security reports go through [SECURITY.md](SECURITY.md).\n\nThe skill stays grounded in cited sources: **if you change a technique claim, cite it.**\n\n## Project structure\n\n```\nprompt-engineering-skill/\n├── plugins/prompt-engineering/        # the Claude Code plugin\n│   └── skills/prompt-engineering/     # the skill itself (source of truth)\n│       ├── SKILL.md                   # entry point + workflow\n│       ├── references/                # technique catalog, model profiles, examples, etc.\n│       └── assets/                    # canonical XML template\n├── adapters/                          # other-tool versions (generated from _core.md)\n│   ├── _core.md                       # single source for the lean adapter body\n│   ├── cursor/  windsurf/  copilot/  codex/\n│   └── README.md\n├── scripts/build-adapters.sh          # regenerate adapters from _core.md\n├── docs/                              # per-platform install guides + website snippets\n├── .github/                           # CI, issue/PR templates, funding\n├── .claude-plugin/marketplace.json    # Claude Code / Copilot marketplace\n├── .cursor-plugin/plugin.json         # native Cursor plugin manifest\n├── gemini-extension.json + GEMINI.md  # Gemini CLI extension\n├── install.sh                         # one-line curl installer\n├── CHANGELOG.md  CONTRIBUTING.md  CODE_OF_CONDUCT.md  SECURITY.md  LICENSE\n```\n\n## License\n\n[MIT](LICENSE) — free to use, modify, and redistribute with attribution.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphalves23%2Fprompt-engineering-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphalves23%2Fprompt-engineering-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphalves23%2Fprompt-engineering-skill/lists"}