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

> Understand the YAML frontmatter in the i-have-adhd SKILL.md file. Learn how it registers, describes, and executes the skill on the OpenCode platform deterministically.

- Repository: [Ayoub Ghriss/i-have-adhd](https://github.com/ayghri/i-have-adhd)
- Tags: deep-dive
- Published: 2026-08-19

---

**The YAML frontmatter in [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md). A Cursor-compatible mirror is maintained at [`.cursor/skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/.cursor/skills/i-have-adhd/SKILL.md) and kept in sync with the primary manifest.

The repository also includes **[`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/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.

```markdown
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.

```js
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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/.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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md)**. A Cursor-compatible mirror is maintained at **[`.cursor/skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/.cursor/skills/i-have-adhd/SKILL.md)**, while **[`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md)** explains the broader architecture.