Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/bastndev/f1/llms.txt

Use this file to discover all available pages before exploring further.

The Create tab lets you generate skill files that are tailored to your project. F1 inspects your workspace — reading package.json, detecting frameworks, scanning scripts, and finding existing instruction files — then produces a ready-to-use Markdown file. You can also describe your project in plain language and let F1 search the marketplace for matching skills to install. Press Alt+1 while the My Skills panel is focused, or run the command f1.mySkills.goCreate from the Command Palette.

The three skill file types

F1 can generate three distinct skill files. Each targets a different agent or purpose.

AGENTS.md

Repository-wide instructions for OpenAI Codex and any agent that follows the AGENTS.md convention. Contains package manager, commands, architecture, conventions, and boundaries detected from the workspace.

CLAUDE.md

Instructions for Claude Code. If AGENTS.md already exists, the generated CLAUDE.md references it with @AGENTS.md and adds only Claude-specific workflow notes, keeping duplication minimal.

DESIGN.md

Design-system and UI guidelines for design-aware agents. Built through a separate wizard that asks you to choose a color palette, typography, and visual style for your product.

The 8 project categories

When creating a skill through the chat-create flow, F1 maps your project to one of eight categories. Each category has its own set of technology options and search signals.
#IDLabelIcon
1webWeb🌐
2mobileMobile📱
3backendBackend⚙️
4ui-uxUI/UX
5aiAI🤖
6testingTesting🧪
7securitySecurity🔒
8databaseDatabase

Creation flows

Guided file generation (AGENTS.md and CLAUDE.md)

F1 uses a workspace inspector to gather context — detected frameworks, package manager, package.json metadata, TypeScript config, build entry points, test setup, and VS Code task/launch configs — before writing the file.
1

Open the Create tab

Press Alt+1 or run f1.mySkills.goCreate. The tab shows buttons for each file type that does not yet exist in your workspace.
2

Choose a file type

Click AGENTS.md or CLAUDE.md. F1 checks whether the file already exists and shows an error if it does, preventing accidental overwrites.
3

Wait for generation

F1 inspects the workspace and generates the Markdown. A minimum 1200 ms loading state ensures the UI feedback is readable before the result appears.
4

Review the result

The file is written to your workspace root. The Local tab refreshes automatically, and you can open the file directly from there or via the standard VS Code file explorer.

Chat-create flow

The chat-create flow lets you describe your project in natural language. F1 searches the marketplace for matching skills and can also generate a boilerplate skill file scoped to a specific category and target folder.
1

Type a description

Enter a description of your project or the kind of skill you need (for example, “React app with Tailwind and Vitest”). F1 pre-warms search in the background while you type.
2

Review search recommendations

F1 returns matching technologies, combos, and marketplace skill recommendations ranked by relevance. A preview of top technologies appears immediately; full results load shortly after.
3

Choose a target

Select whether the skill should be created in .agents/skills/ (recommended, for Codex-compatible agents) or .claude/skills/ (for Claude Code).
4

Generate the skill

Confirm the name, category, and description. F1 creates the skill folder with a SKILL.md manifest and any supporting files, then fires a skills-change event so the Local tab refreshes.

Fast templates

Fast templates skip the search step and generate a skill directly from a selected category. F1 translates your project name and description to English if needed before passing them to the generator, ensuring consistent output regardless of input language.

DESIGN.md wizard

The DESIGN.md wizard is a separate flow that asks three questions:
  1. Color — pick a color palette (or skip).
  2. Typography — pick a type scale (or skip).
  3. Style — pick a visual style (or skip).
At least one of the three must be selected. F1 combines your choices with the workspace name to produce a DESIGN.md tailored to your product. If DESIGN.md already exists you will be asked whether to overwrite it.

Description enhancement

Before generating a skill in the chat-create flow, F1 can improve a non-English description by translating it to English. The translated query is used for both marketplace search and skill generation, so you can describe your project in any language and still get accurate results.
All three skill file types (AGENTS.md, CLAUDE.md, DESIGN.md) are tracked by F1’s file watcher. If you edit or delete them manually, the Create tab button states and the Local tab list update automatically.

Build docs developers (and LLMs) love