Agent Skill Export

Agent Skill Export generates a SKILL.md file from the files you select in Q and packages it into a downloadable skill folder. The resulting export is designed for Claude Code and other tools that support the open Agent Skills format.

What It Does

Q builds a single generated skill from your selected content:

• It creates one SKILL.md
• It combines the selected Q files into one structured skill document
• It includes frontmatter with a generated skill name and description
• It gives you a preview before download
• It can provide a one-click Cursor deeplink when the generated skill is small enough

If you want to learn more about the format itself, see Agent Skills.

How It Works

Selection Behavior

The selector follows the same rules as the other export builders:

• All exportable markdown files and mission boards are selected by default
• Mission body files are not shown as separate top-level choices
• Selecting a mission board includes all of its mission items automatically
• Internal files like manifest.json are excluded
• If nothing is selected, export and preview are disabled

Generated Output

Q generates a single skill document with:

• YAML frontmatter
• A generated name prefixed with heyq-
• A generated description for the selected project
• A When to use this skill section
• A combined Project Context section built from the selected files

Markdown files are included directly, while mission boards are converted into markdown with their board metadata and included mission items.

Download Structure

The ZIP contains a folder like this:

heyq-your-project/
  SKILL.md

The ZIP filename is based on the project name, for example:

heyq-your-project-skill.zip

Preview and Installation

• Preview shows the generated SKILL.md content in a dialog
• Add to Cursor is available when the generated skill fits within Cursor's deeplink size limits
• Download Skill Folder is the fallback for larger skills and the primary export method