How It Works

PMMCraft is a skill library for Okta PMMs. Create, share, and reuse Claude skill files that automate your most common product marketing workflows.

What is a Claude skill file?

A skill file is a Markdown document that gives Claude specific instructions for a task. When you add a skill file to a Claude project, Claude follows those instructions whenever you ask it to perform that type of work. Instead of re-explaining your process every time, the skill encodes your expertise once and Claude applies it consistently.

Skill file structure

PMMCraft follows the Agent Skills specification, making your skills portable across any compatible AI agent. A skill can be a single file or a full package with scripts, references, and assets.

Directory structure

my-skill/
├── SKILL.md          # Required: metadata + instructions
├── scripts/          # Optional: executable code
│   └── analyze.py
├── references/       # Optional: documentation
│   └── REFERENCE.md
└── assets/           # Optional: templates, resources
    └── template.md

SKILL.md format

Every skill needs a SKILL.md file at the root. It starts with YAML frontmatter for metadata, followed by the actual skill instructions in Markdown.

---
name: competitive-battle-card
description: Generates structured competitive
  battle cards for Okta vs. competitors.
license: Apache-2.0
compatibility: Designed for Claude Code
metadata:
  author: pmm-team
  version: "1.0"
---

# Competitive Battle Card Generator

## Role
You are an expert competitive intelligence
analyst for Okta.

## Instructions
1. Ask the user which competitor to analyze
2. Research strengths and weaknesses
3. Generate the battle card following the
   format below

## Output Format
- Overview
- Key differentiators
- Objection handling
- Win/loss talking points

Frontmatter fields

name
Required. Lowercase letters, numbers, and hyphens. Max 64 characters. Must match the folder name.
description
Required. What the skill does and when to use it. Max 1024 characters. Be specific so agents can match tasks to the right skill.
license
Optional. License name or reference to a bundled LICENSE file.
compatibility
Optional. Environment requirements like intended product, system packages, or network access.
metadata
Optional. Key-value pairs for author, version, or any custom properties.
allowed-tools
Optional. Space-delimited list of pre-approved tools the skill may use (e.g. Bash(git:*) Read).

You can upload a single SKILL.md file or a .zip containing the full skill folder. PMMCraft reads the frontmatter automatically to populate the skill title, description, and metadata.

Getting started

1

Build a skill following the Agent Skills spec

Create a SKILL.md file with YAML frontmatter and Markdown instructions. For complex skills, organize scripts, references, and assets in a folder. The spec keeps your skills portable across any compatible AI agent.

2

Publish it to PMMCraft

Upload a single SKILL.md, drag and drop a folder, or upload a .zip of your skill package. PMMCraft reads the frontmatter to populate the title and description automatically. Add a category and tags so your teammates can find it.

3

Download and use in Claude

Browse skills published by the team. When you find one you need, download it and add it to your Claude project. Single-file skills download as .md, multi-file packages download as .zip with the original folder structure preserved.

Skill ideas for Okta PMMs

Positioning Document

A skill that guides Claude through creating a positioning document following Okta's framework, including target audience, market category, key differentiators, and proof points.

Competitive Battle Card

A skill that generates structured competitive battle cards with strengths, weaknesses, objection handling, and win/loss analysis for Okta vs. competitors.

Launch Tier Assessment

A skill that helps determine the right launch tier for a feature or product based on market impact, revenue potential, and strategic alignment.

Messaging Framework

A skill that walks Claude through building a messaging hierarchy, covering headline, sub-messages, proof points, and persona-specific variations.

Tips for writing great skills

  • •Be specific. The more detail you give Claude about the output format, tone, and structure, the better the results.
  • •Include examples. Show Claude what good output looks like. A short example in the skill file goes a long way.
  • •Use Okta context. Reference Okta-specific frameworks, terminology, and audience segments so Claude produces work that fits how your team operates.
  • •Keep it focused. One skill per task. A skill that does one thing well is more reusable than one that tries to do everything.

Ready to get started?

Browse skills published by the Okta PMM team or create your own.

Browse skillsCreate a New Skill