Guide · Agent skill
How to use the Intended vs Implemented agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
Intended vs Implemented is an agent skill for finding places where the code does something other than what its documentation says. This page covers the copy inside the phuryn/pm-skills repository, which is a pointer: the working skill now lives in the phuryn/product-engineering repository, inside its ai-shipping plugin. Read this to understand what the copy does, how to get the maintained version, and what to do if your agent loaded this copy.
Intended vs Implemented (moved)phuryn/pm-skills · MIT Download the skill Quick start
- 1Confirm what you have loaded. Check whether you loaded the pm-skills copy of intended-vs-implemented or the ai-shipping version. This copy only redirects.
- 2Add the marketplace. Run claude plugin marketplace add phuryn/product-engineering in Claude Code. This needs network access to GitHub.
- 3Install the plugin. Run claude plugin install ai-shipping@product-engineering to install the ai-shipping plugin that contains the maintained skill.
- 4Disable the pointer copy. Turn off pm-ai-shipping in pm-skills so only the maintained skill loads.
- 5Ask for the audit in plain language. Describe the mismatch you want found, such as where the code differs from the docs, and let the installed skill handle it.
What this skill makes the agent do
The SKILL.md file in pm-skills does not contain an audit method. Its job is to tell the agent that intended-vs-implemented has moved to phuryn/product-engineering, maintained in the ai-shipping plugin, and to say how to proceed.
If the ai-shipping:intended-vs-implemented skill is already installed, the agent should use that version instead of this copy. If it is not installed, the agent tells you where the skill moved, gives install commands, and then helps with your task without the skill.
- Use this copy only as a signpost.
- The description says the skill is used when asked to find where the code does something other than its docs say.
- This copy itself does not check code against documentation.
Install the maintained version
The source gives two Claude Code commands. The first adds the phuryn/product-engineering marketplace, and the second installs the ai-shipping plugin from it. Running them requires Claude Code with the plugin command available and network access to GitHub.
This install adds a third-party marketplace and installs a plugin from it. Review that before running the commands if you are not comfortable with that.
If you use another agent rather than Claude Code, the source points to the repository README at https://github.com/phuryn/product-engineering#install for instructions.
claude plugin marketplace add phuryn/product-engineering
claude plugin install ai-shipping@product-engineeringTurn off the pointer copy after installing
Once the ai-shipping plugin is installed, the source says to turn off pm-ai-shipping in pm-skills so this copy no longer loads beside the maintained one. This avoids the agent seeing two versions of the same skill.
The source does not describe the exact steps for disabling a plugin, so follow your agent's own plugin controls for that.
How to trigger it with natural requests
The skill is described as useful when you ask an agent to find where the code does something other than its docs say. Phrase requests around that goal, for example asking the agent to compare what a README or spec says a feature does with what the code actually does.
If you have only this pm-skills copy loaded, expect the agent to point you to the maintained version rather than run an audit.
- Ask: find where the code does something other than the docs describe.
- Ask: check whether the implementation matches what the documentation promises.
- Expect a redirect from this copy if ai-shipping is not installed.
What it needs and what it does on your machine
The source lists these requirements: Claude Code with the plugin command available, for the install commands shown, and network access to GitHub to add the phuryn/product-engineering marketplace.
The skill runs no scripts. It does use the network, because the install step contacts GitHub.
- Requires Claude Code with the plugin command.
- Requires network access to GitHub for the marketplace.
- Runs scripts: no.
- Uses network: yes.
Safety notes
Adding a marketplace and installing a plugin brings third-party code into your agent environment. The source makes this explicit, so check the repository before you install if that matters for your project.
Because this copy has no audit method, do not treat it as a verification tool. Nothing in the SKILL.md file checks your code.
- The install step adds a third-party marketplace.
- The install step installs a plugin from that marketplace.
- This copy contains no audit logic.
What people use it for
- Finding where a feature's implementation differs from its README or spec.
- Checking whether documented behaviour matches what the code does before a release.
- Getting pointed to the maintained ai-shipping version when an agent loads this pm-skills copy.
Frequently asked questions
Does this copy of intended-vs-implemented audit my code?
No. The SKILL.md file in pm-skills is a pointer. It says the skill moved to phuryn/product-engineering and gives install steps, but it contains no audit method.
How do I install intended-vs-implemented?
Run claude plugin marketplace add phuryn/product-engineering, then claude plugin install ai-shipping@product-engineering. The skill is maintained in the ai-shipping plugin.
What do I need to use it?
Claude Code with the plugin command available, plus network access to GitHub to add the phuryn/product-engineering marketplace. The skill runs no scripts.
Is it free to use?
The source states the license is MIT. It does not mention pricing, so check the repository for any other terms.
Can I use it with agents other than Claude Code?
The source points to the repository README at https://github.com/phuryn/product-engineering#install for other agents. It does not give commands for them.
Why does the agent keep pointing to a new location?
This pm-skills copy exists so an agent that loads it knows the skill moved. Once ai-shipping is installed, turn off pm-ai-shipping in pm-skills so this copy stops loading.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use this page if an agent sent you here or you want the ai-shipping version of intended-vs-implemented, which is the maintained skill. Do not expect this pm-skills copy to audit code, and skip the install if you do not want to add a third-party plugin marketplace to Claude Code.
Download the skill