Where to Find Skill Files in phuryn/pm-skills: Repository Structure Guide

Skill files in phuryn/pm-skills are located at pm-<domain>/skills/<skill-name>/SKILL.md, with each product management domain containing its own skills subdirectory.

The phuryn/pm-skills repository organizes reusable LLM prompts for product managers as structured Markdown files. Understanding where these skill files live helps you browse, reference, or programmatically load specific capabilities for strategy, discovery, execution, and analytics workflows.

Skill File Location Patterns

Every reusable skill in the repository follows a strict file naming convention. The SKILL.md files live in domain-specific subdirectories under the top-level pm-* directories.

The path pattern is:

pm-<domain>/skills/<skill-name>/SKILL.md

The repository contains skills across eight product management domains:

• pm-toolkit – General utilities like resume reviews and document drafting
• pm-product-strategy – Strategic frameworks including SWOT analysis
• pm-product-discovery – Feature prioritization and user research methods
• pm-marketing-growth – Growth metrics and marketing strategies
• pm-go-to-market – GTM planning and launch strategies
• pm-execution – Delivery artifacts like user stories
• pm-data-analytics – SQL queries and data analysis prompts
• pm-ai-shipping – AI-specific shipping workflows

Examples of Skill File Paths

You can browse example skill files directly on GitHub or in your local clone using these canonical paths:

• Resume Review (Toolkit): pm-toolkit/skills/review-resume/SKILL.md
• Draft NDA (Toolkit): pm-toolkit/skills/draft-nda/SKILL.md
• SWOT Analysis (Product Strategy): pm-product-strategy/skills/swot-analysis/SKILL.md
• Prioritize Features (Product Discovery): pm-product-discovery/skills/prioritize-features/SKILL.md
• North Star Metric (Marketing): pm-marketing-growth/skills/north-star-metric/SKILL.md
• GTM Strategy (Go-to-Market): pm-go-to-market/skills/gtm-strategy/SKILL.md
• User Stories (Execution): pm-execution/skills/user-stories/SKILL.md
• SQL Queries (Data Analytics): pm-data-analytics/skills/sql-queries/SKILL.md
• Shipping Artifacts (AI Shipping): pm-ai-shipping/skills/shipping-artifacts/SKILL.md

Each SKILL.md contains YAML frontmatter defining inputs, outputs, and the LLM prompt that drives the skill.

Accessing Skill Files Programmatically

When building integrations or CLI tools around the phuryn/pm-skills repository, you can load and parse these files directly.

Loading a Skill Definition in Python

Use pathlib to read the Markdown content as a string:

from pathlib import Path

def load_skill(skill_path: str) -> str:
    """Read a SKILL.md file and return its contents."""
    return Path(skill_path).read_text(encoding="utf-8")

# Example: load the "review-resume" skill

skill_md = load_skill(
    "pm-toolkit/skills/review-resume/SKILL.md"
)
print(skill_md[:200])   # preview the first 200 characters

Parsing Skill Metadata in Node.js

Extract the YAML frontmatter to access the skill's parameters:

const fs = require('fs');
const path = require('path');

/**
 * Extract the YAML front-matter from a SKILL.md file.
 */
function getSkillMeta(skillDir) {
  const file = path.join(skillDir, 'SKILL.md');
  const content = fs.readFileSync(file, 'utf8');
  const [, yaml] = content.match(/^---\n([\s\S]*?)\n---/m) || [];
  return yaml ? yaml.trim() : null;
}

// Example: read metadata for the "swot-analysis" skill
const meta = getSkillMeta('pm-product-strategy/skills/swot-analysis');
console.log(meta);

Executing Skills via CLI

Run a skill directly using the bundled command-line interface:

# Assuming the repository's CLI entry point is `pm-skills`

pm-skills run \
  --skill pm-market-research/skills/competitor-analysis/SKILL.md \
  --input "Analyze competitors for a SaaS budgeting tool"

Summary

• Skill files in phuryn/pm-skills are always named SKILL.md and follow the path pattern pm-<domain>/skills/<skill-name>/SKILL.md.
• The repository organizes skills into eight product management domains including toolkit, strategy, discovery, execution, and analytics.
• Each skill file contains YAML frontmatter defining inputs and outputs, followed by the LLM prompt.
• You can load skills programmatically using standard file I/O in Python or Node.js, or execute them via the bundled CLI.

Frequently Asked Questions

What is the naming convention for skill files in phuryn/pm-skills?

Every skill file must be named exactly SKILL.md and reside in a subdirectory under pm-<domain>/skills/<skill-name>/. This convention ensures the repository's automated tools can discover and execute skills consistently across all product management domains.

How do I load a specific skill file in Python?

Use the pathlib module to read the file as UTF-8 text. Reference the file using the relative path from the repository root, such as pm-toolkit/skills/review-resume/SKILL.md. The file contains Markdown with YAML frontmatter describing the skill's metadata and the prompt template.

Where are the GTM and strategy skill files located?

Go-to-market skills are located in pm-go-to-market/skills/, such as pm-go-to-market/skills/gtm-strategy/SKILL.md. Product strategy skills live in pm-product-strategy/skills/, including pm-product-strategy/skills/swot-analysis/SKILL.md. Each skill follows the standard SKILL.md format with domain-specific parameters.

Can I execute skill files directly from the command line?

Yes, the repository provides a CLI tool accessed via the pm-skills command. You can execute any skill by passing the path to its SKILL.md file using the --skill flag, along with your input parameters using --input. This allows you to run product management workflows without writing custom code.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}