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).
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.
Avoid it when your spec is not in PDF/DOCX form or when no supported API key is configured in your environment.
Security analysis
CautionThe 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.
- •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.
Examples
Here's my PRD: ./docs/checkout-prd.pdf — generate Cursor rules from it.Split ./specs/payments-prd.docx into multiple focused Claude Code command files and name them payments.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 filesThis 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.mdFrom 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 installationopenskills 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 syncManual 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.
Supabase Docs Authoring
Documentation
Write, edit, and review Supabase documentation content including guides, tutorials, reference docs, and partials. Follow style guides and MDX/TOML validation rules.
Create Architecture Decision Record
Documentation
Create a new Architecture Decision Record with sequential numbering, register it in the AgentDB graph, and link related ADRs.
Plan update with deep research
Documentation
Updates a plan document by launching parallel subagents to analyze a topic across all compiler passes, then consolidates findings into the plan doc.