Significance of the Frontmatter in the i-have-adhd SKILL.md File

The YAML frontmatter in skills/i-have-adhd/SKILL.md serves as the canonical manifest that tells the OpenCode platform how to register, describe, and deterministically execute the i-have-adhd skill without invoking a generative model.

The ayghri/i-have-adhd repository defines a productivity skill that structures output for readers with ADHD. The significance of the frontmatter in the SKILL.md file is that it supplies the machine-readable metadata the runtime needs for discovery, licensing, and execution control. Each key-value pair in this YAML block directly dictates how compatible agents load the skill and what behavior users experience when they invoke it.

Core Frontmatter Fields in i-have-adhd SKILL.md

OpenCode-compatible agents read the YAML block at the top of the skill’s markdown file as a manifest. This manifest allows the system to register the skill under a stable identifier, render catalog entries for users, enforce deterministic execution rules, and respect software licensing requirements.

Identity, Description, and Discovery

The name field supplies the unique token that users and systems use to trigger the skill. According to the ayghri/i-have-adhd source code, this value is set to i-have-adhd, which enables invocation via the /i-have-adhd command.

The description field provides a concise, human-readable summary of the skill’s purpose. Platforms display this text in plugin catalogs, documentation generators, and browsing UIs so users understand the skill’s ADHD-focused output constraints before installing or running it.

The metadata.tags entry contains searchable keywords such as ADHD, Output Style, and Productivity. These tags allow users to find the skill through catalog search and filtered queries.

The metadata.category field groups the skill under the productivity domain. Organizing plugins by category helps UI panels render related skills together and supports analytics pipelines that track usage across domains.

Execution Mode and Licensing

The disable-model-invocation: true flag is a critical directive that tells the runtime not to forward requests to a language model. Instead, the agent executes the skill’s deterministic rule set directly from the file body. This guarantees that ADHD-focused formatting constraints are applied consistently without generative variance.

The license: MIT entry declares the open-source license. Downstream tools, package managers, and corporate integrations read this field to ensure compliance before loading or redistributing the skill.

Manifest Architecture and File Locations

The canonical source of truth for this metadata lives at skills/i-have-adhd/SKILL.md. A Cursor-compatible mirror is maintained at .cursor/skills/i-have-adhd/SKILL.md and kept in sync with the primary manifest.

The repository also includes AGENTS.md, which documents where the skill fits within the broader agent architecture and explains how the runtime interprets these manifest values during load time.

Usage Examples: From Chat to Code

Invoking the Skill via Chat

When a user types the command mapped to the name field, the runtime routes the request to the local rule set rather than a model.

User: /i-have-adhd
Assistant: 1️⃣ Open `src/auth.ts`
         2️⃣ Replace the token verification block…

Programmatic Loading

The following pseudo-code illustrates how an OpenCode loader extracts the frontmatter values to build the skill object at runtime.

import { loadSkill } from 'opencode-runtime';

await loadSkill({
  name: 'i-have-adhd',
  description: 'Shape output for a reader with ADHD…',
  disableModelInvocation: true,
  license: 'MIT',
  tags: ['ADHD', 'Output Style', 'Productivity'],
  category: 'productivity'
});

Summary

• The YAML frontmatter in skills/i-have-adhd/SKILL.md functions as the canonical manifest for the skill.
• The name field provides the unique invocation token (/i-have-adhd), while description, tags, and category drive discovery and UI rendering.
• Setting disable-model-invocation: true forces deterministic, rule-based execution instead of generative model behavior.
• The license: MIT entry ensures downstream compliance, and the manifest is mirrored under .cursor/skills/i-have-adhd/SKILL.md for cross-platform compatibility.

Frequently Asked Questions

What does the disable-model-invocation field do in the i-have-adhd SKILL.md file?

It tells the OpenCode runtime to skip the language model and execute the deterministic rules defined in the skill body directly. This ensures that ADHD-specific output formatting remains consistent and predictable across every invocation.

How does the name field in SKILL.md control skill invocation?

The name field defines the unique identifier that maps to the /i-have-adhd command. When a user or script sends this token, the runtime looks up the manifest and routes execution to the corresponding rule set in skills/i-have-adhd/SKILL.md.

Why is frontmatter required in the i-have-adhd SKILL.md file?

Without the YAML frontmatter, the OpenCode platform would lack the metadata needed to register, categorize, license, and enforce execution modes for the skill. The frontmatter effectively serves as the bridge between human-readable documentation and machine-readable configuration.

Where is the canonical SKILL.md file located in the repository?

The source-of-truth manifest resides at skills/i-have-adhd/SKILL.md. A Cursor-compatible mirror is maintained at .cursor/skills/i-have-adhd/SKILL.md, while AGENTS.md explains the broader architecture.

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