Convert PRD to AI Assistant Instructions

VerifiedCaution

Interactive guide to convert a PRD document (PDF or DOCX) into instruction files for AI coding assistants like Claude Code, Cursor, Copilot, Windsurf, and Codex.

Sby Skills Guide Bot
DocumentationBeginner
7/23/2026
Claude CodeCursorWindsurfCopilotCodex
#prd#spec-to-code#ai-instructions#cli#multi-tool

Recommended for

Automated summary

This skill walks the user step by step through turning a PDF or DOCX PRD into AI coding assistant instruction files using npx prd-to-skill.

Strengths

  • Supports six targets (claude, cursor, copilot, windsurf, codex, aider) and writes to the correct output path for each.
  • Offers a split mode that breaks the PRD down by topic (tech stack, business rules, architecture) so only the relevant context gets loaded.
  • Asks one question at a time, prints the exact command and requires explicit confirmation before running it.
  • Reuses whichever API key is already set in the environment (OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY or MISTRAL_API_KEY).

Limitations

  • Requires Node/npx, network access and a valid API key to work.
  • Only accepts PRDs supplied as PDF or DOCX files.
  • Split mode is skipped for codex and aider, which produce a single output file (AGENTS.md or CONVENTIONS.md).
When to use it

Use it when you have a PDF or DOCX PRD and want to generate rules or instruction files for your coding assistant without hand-writing them.

When not to use it

Avoid it when your spec is not in PDF/DOCX form or when no supported API key is configured in your environment.

Security analysis

Caution
Quality score88/100

The skill guides the user through running a third-party command-line tool that processes documents and makes network calls to external AI services. While the purpose is legitimate and not inherently destructive, it involves downloading code from npm and transmitting potentially sensitive PRD content to external APIs, which warrants caution.

Findings
  • •Runs an external npm package via npx, which may download and execute arbitrary code.
  • •Sends the user's PRD content to external AI APIs using environment variables (OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY, MISTRAL_API_KEY), potentially exposing proprietary documents.
  • •Uses shell command execution (`!npx`) without declared allowed-tools.
How this analysis is made

Examples

PRD to Cursor rules
Here's my PRD: ./docs/checkout-prd.pdf — generate Cursor rules from it.
Split PRD into focused Claude commands
Split ./specs/payments-prd.docx into multiple focused Claude Code command files and name them payments.
AGENTS.md for Codex
Turn ./prd.docx into an AGENTS.md file for Codex.

name: prd-to-skill description: Convert a PRD (PDF or DOCX) into AI coding assistant instruction files for Claude Code, Cursor, Copilot, Windsurf, Codex, or Aider.

Guide the user through converting a PRD document into AI coding assistant instruction files using npx prd-to-skill. Ask one question at a time. At the end, show the full command and run it.

Step 1 — File

Ask: "What's the path to your PRD file? (PDF or DOCX)"

Step 2 — Target

Present these options and ask which tool they're generating for:

| # | Target | Output location | | --- | -------------------- | --------------------------------------------- | | 1 | claude (default) | .claude/commands/<name>.md | | 2 | cursor | .cursor/rules/<name>.mdc | | 3 | copilot | .github/instructions/<name>.instructions.md | | 4 | windsurf | .windsurf/rules/<name>.md | | 5 | codex | ./AGENTS.md | | 6 | aider | ./CONVENTIONS.md |

Step 3 — Single file or split (skip for codex and aider)

If the target is codex or aider, skip this step — they only support a single output file.

Otherwise ask: "Do you want a single skill file (one complete instruction file) or multiple focused files that split the PRD by topic — tech stack, business rules, architecture, and so on? Split lets you load only what's relevant to your current task."

Step 4 — Name (optional)

Ask: "What name should the output use? (Leave blank to derive from the filename)"

If they skip or say nothing meaningful, omit --name.

Step 5 — Confirm and run

Show the exact command you are about to run, for example:

npx prd-to-skill ./my-prd.pdf --target cursor --name auth-feature
npx prd-to-skill split ./my-prd.pdf --target claude

Then say: "This will use whichever API key you have set (OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY, or MISTRAL_API_KEY). Ready to go?"

Once confirmed, run the command with !npx prd-to-skill ....

From the file to a first result

The download contains exactly the content displayed on this page. This copy may differ from the latest version in the source repository.

View the source and supporting files

This download contains SKILL.md only. Any scripts, references, templates and dependencies are not included. Get the required files from the source, preserving their directory structure, before continuing.

1. Download the file

Download SKILL.md

From the root of a test project, save the file as .skill-downloads/convert-prd-to-ai-assistant-instructions-mrx3y06q/SKILL.md, or use the command below. This folder is for inspecting the skill before installation.

Command for macOS/Linux or WSL: requires a POSIX shell and curl. On Windows without WSL, use the download button and create the folder manually.

mkdir -p '.skill-downloads/convert-prd-to-ai-assistant-instructions-mrx3y06q' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/convert-prd-to-ai-assistant-instructions-mrx3y06q/download' --output '.skill-downloads/convert-prd-to-ai-assistant-instructions-mrx3y06q/SKILL.md.part' && mv '.skill-downloads/convert-prd-to-ai-assistant-instructions-mrx3y06q/SKILL.md.part' '.skill-downloads/convert-prd-to-ai-assistant-instructions-mrx3y06q/SKILL.md'

2. Check prerequisites

Read SKILL.md before using it. If it references scripts or external services, inspect them and prepare the required access in your test environment.

No recognized prerequisites section in this file. This does not mean it is self-contained: libraries, tools and access requirements may be mentioned elsewhere in the content or source repository.

The platforms on this page are catalog indications. The paths below follow tool documentation; they do not prove this skill has been run in those tools. No minimum tool version is confirmed for this listing.

3. Load the skill

After inspection, copy the complete folder into your project using one of the commands below, then open a new tool session. The command stops if a folder with the same name already exists: compare the files before replacing it.

Claude Code
test -f '.skill-downloads/convert-prd-to-ai-assistant-instructions-mrx3y06q/SKILL.md' && test -s '.skill-downloads/convert-prd-to-ai-assistant-instructions-mrx3y06q/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/prd-to-skill' && cp -R '.skill-downloads/convert-prd-to-ai-assistant-instructions-mrx3y06q' '.claude/skills/prd-to-skill'

Cursor
test -f '.skill-downloads/convert-prd-to-ai-assistant-instructions-mrx3y06q/SKILL.md' && test -s '.skill-downloads/convert-prd-to-ai-assistant-instructions-mrx3y06q/SKILL.md' && mkdir -p '.cursor/skills' && test ! -e '.cursor/skills/prd-to-skill' && cp -R '.skill-downloads/convert-prd-to-ai-assistant-instructions-mrx3y06q' '.cursor/skills/prd-to-skill'

Codex
test -f '.skill-downloads/convert-prd-to-ai-assistant-instructions-mrx3y06q/SKILL.md' && test -s '.skill-downloads/convert-prd-to-ai-assistant-instructions-mrx3y06q/SKILL.md' && mkdir -p '.agents/skills' && test ! -e '.agents/skills/prd-to-skill' && cp -R '.skill-downloads/convert-prd-to-ai-assistant-instructions-mrx3y06q' '.agents/skills/prd-to-skill'

OpenSkills

OpenSkills must already be installed. The local install/read procedure is checked with OpenSkills 1.5.0, which requires Node.js ≥ 20.6.0. Catalog slugs are not resolved automatically.

Official OpenSkills installation
openskills install './.skill-downloads/convert-prd-to-ai-assistant-instructions-mrx3y06q'

openskills read 'convert-prd-to-ai-assistant-instructions-mrx3y06q'

Reading should display the installed file content and its base directory. It does not run the skill or install its dependencies.

For an agent that reads AGENTS.md, then sync the index. This command changes AGENTS.md: review the diff before using it.

openskills sync

Manual method or another tool: attach SKILL.md to a conversation, or open it in an agent that can read files. Include any required supporting resources. No universal folder is recognized by every tool.

4. Try a first task

Use a short, synthetic input: an API endpoint, a small document or an interface brief. In a new conversation, attach the file or give the agent its path, then adapt this request:

Read .skill-downloads/convert-prd-to-ai-assistant-instructions-mrx3y06q/SKILL.md and apply its instructions to this example: [describe a test input]. Identify any missing files, dependencies or access. Produce the result requested by the skill without inventing data or running unreviewed scripts.

Expected result: output matching the skill instructions, or a precise list of missing prerequisites. A read confirmation alone does not validate a first use. If an external resource is unavailable, that path remains untested.

Related skills