Syncing Prompts & Skills

The CLI can download all your accessible content for offline use and integration with local tools.

Syncing Prompts

bash

heroprompt sync sync-cmd

This downloads all prompts into ~/.heroprompt/prompts/, organized by category and subcategory:

text

~/.heroprompt/prompts/
├── productivity/
│   ├── excel/
│   │   └── excel-formula-wizard.json
│   └── word/
│       └── word-professional-resume.json
├── technology/
│   └── frontend/
│       └── frontend-state-management.json
└── image/
    └── photography/
        └── image-product-photography.json

Each prompt file contains the full prompt template with metadata:

json

{
  "id": "excel-formula-wizard",
  "name": "Excel Formula Wizard (Pro)",
  "category": "productivity",
  "subcategory": "excel",
  "description": "Generate complex Excel formulas...",
  "tags": ["excel", "formulas"],
  "template": "You are an expert in Excel formulas...",
  "variables": [{"name": "task", "type": "text", "required": true}]
}

Filtering

bash

# Only sync prompts from a specific subcategory
heroprompt sync sync-cmd --role frontend

Overwriting

By default, existing files are skipped. Use --force to overwrite:

bash

heroprompt sync sync-cmd --force

Syncing Skills

Skills require a PRO Kit or Lifetime subscription.

bash

heroprompt sync sync-skill mcp-server

Each Skill is downloaded as a directory with metadata and individual step files:

text

~/.heroprompt/skills/mcp-server-builder/
├── skill.json           # Metadata
└── steps/
    ├── 01-research--planning.md
    ├── 02-implementation.md
    ├── 03-quality-review.md
    └── 04-evaluation.md

Partial ID Matching

You don't need the full skill ID. The CLI will match partial IDs:

bash

heroprompt sync sync-skill mcp      # Matches "mcp-server-builder"
heroprompt sync sync-skill react    # Matches "react-design-system"

If multiple Skills match, the CLI lists them for you to choose.

Using Synced Content

Once synced, prompts and Skills are plain JSON/Markdown files. You can:

Reference them in your IDE — Copy templates directly
Build automation — Parse JSON files in your scripts
Version control — Track changes with git
Share with your team — Distribute via shared directories