How do I install the Chi Search skill?

Run npx skillmds@latest add tomevault-io/chi-search in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Chi Search safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Chi Search?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Chi Search free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Chi Search?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Chi Search by tomevault-io — Agent Skill

Name: Chi Search
Author: tomevault-io

Chi Search

Search across Chi Design System elements using natural language or keywords. Use when the user asks to find Chi elements, search for components by use case, or discover related utilities/tokens/components. Supports synonym expansion for better discoverability. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

Chi Semantic Search

How to Search

When user searches for Chi elements, use these strategies in order:

1. Direct Match

Search for exact class names, component names, or token names:

Tokens: Check chi-tokens reference data or read src/chi/_global-variables.scss
Utilities: Check chi-utilities reference data
Components: Check chi-components reference data
Schemas: Check chi-component-schemas/schemas.json

2. Synonym Expansion

Expand search terms using the synonym dictionary in reference.md. Example: "center" also matches "middle", "centered", "align-center".

3. Use Case Matching

Match natural language queries to common use cases in reference.md. Example: "center content" → -mx--auto, -d--flex, -justify-content--center, -align-items--center

4. Fuzzy Matching

If no exact match, try partial matches: "btn" → chi-button, "mod" → chi-modal

Ranking Criteria

Results are ranked by relevance:

Exact name match (highest) -- query matches element name exactly
Prefix match -- query is a prefix of the element name
Use case match -- query matches a documented use case
Synonym match -- query matches via synonym expansion
Partial match (lowest) -- query appears somewhere in name or description

Search Scope

Search covers:

Component names, modifiers, and subcomponents
Utility class names and their CSS properties
Token names and values
Use case descriptions and synonyms

Workflow

Parse the user's query into keywords
Try direct match first (fastest)
Expand keywords with synonyms from reference.md
Match against use cases for natural language queries
Return ranked results grouped by type

Response Format

Return results grouped by type:

Components: Name, description, Web Component tag, key modifiers
Utilities: Class name, CSS properties, category, example
Tokens: Token name, value, description
Use Cases: Matching pattern with all related elements and code example

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: chi-searchdescription: Search across Chi Design System elements using natural language or keywords. Use when the user asks to find Chi elements, search for components by use case, or discover related utilities/tokens/components. Supports synonym expansion for better discoverability. Use when this capability is needed.---# Chi Semantic Search## How to SearchWhen user searches for Chi elements, use these strategies in order:### 1. Direct MatchSearch for exact class names, component names, or token names:- Tokens: Check chi-tokens reference data or read `src/chi/_global-variables.scss`- Utilities: Check chi-utilities reference data- Components: Check chi-components reference data- Schemas: Check chi-component-schemas/schemas.json### 2. Synonym ExpansionExpand search terms using the synonym dictionary in [reference.md](reference.md).Example: "center" also matches "middle", "centered", "align-center".### 3. Use Case MatchingMatch natural language queries to common use cases in [reference.md](reference.md).Example: "center content" → `-mx--auto`, `-d--flex`, `-justify-content--center`, `-align-items--center`### 4. Fuzzy MatchingIf no exact match, try partial matches: "btn" → `chi-button`, "mod" → `chi-modal`## Ranking CriteriaResults are ranked by relevance:1. **Exact name match** (highest) -- query matches element name exactly2. **Prefix match** -- query is a prefix of the element name3. **Use case match** -- query matches a documented use case4. **Synonym match** -- query matches via synonym expansion5. **Partial match** (lowest) -- query appears somewhere in name or description## Search ScopeSearch covers:- Component names, modifiers, and subcomponents- Utility class names and their CSS properties- Token names and values- Use case descriptions and synonyms## Workflow1. Parse the user's query into keywords2. Try direct match first (fastest)3. Expand keywords with synonyms from reference.md4. Match against use cases for natural language queries5. Return ranked results grouped by type## Response FormatReturn results grouped by type:- **Components**: Name, description, Web Component tag, key modifiers- **Utilities**: Class name, CSS properties, category, example- **Tokens**: Token name, value, description- **Use Cases**: Matching pattern with all related elements and code example---> Converted and distributed by [TomeVault](https://tomevault.io/claim/centurylink) — claim your Tome and manage your conversions.

Frequently asked questions