A high-fidelity grounding skill that prevents AI models from hallucinating Apple SF Symbol names, ensuring type-safe compilation for iOS, iPadOS, and macOS apps.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install sfsymbolskit
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install sfsymbolskit using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is SFSymbolsKit?
Apple's native SF Symbol APIs rely on fragile string-based initializers like Image(systemName:) and UIImage(systemName:). Because wrong names compile without errors but render blank icons in production, AI models routinely generate plausible but completely fictional symbol names. The SFSymbolsKit skill solves this problem within the ecosystem of Openclaw Skills by forcing AI agents to verify symbol names against an authoritative catalog of 7,007 verified entries.
By integrating this skill, your AI assistant matches user queries against actual, validated SF Symbols (up to version 7.2) and outputs type-safe SFSymbolsKit accessors. This converts fragile, error-prone stringly-typed references into robust, compiler-enforced Swift code.
SFSymbolsKit Use Cases
- Preventing silent runtime UI rendering failures by verifying all SF Symbols during code generation.
- Resolving semantic or natural-language symbol queries (e.g., searching for 'trash' or 'arrow up') into precise official SF Symbol names.
- Generating type-safe Swift code accessors for SwiftUI, UIKit, and AppKit applications.
- Automatically integrating the SFSymbolsKit package dependency into active iOS or macOS projects that require compiler validation.
How SFSymbolsKit Works
- Context Interception: The AI agent detects when you are generating, updating, or fixing UI layouts that use Apple SF Symbols.
- Catalog Querying: The agent queries its local database (
symbols.json) or connects to an SFSymbolsKit Model Context Protocol (MCP) server if one is available. - Semantic Matching: It maps descriptive names to the canonical dotted name or camelCase properties (e.g., mapping 'square and arrow up' to
squareAndArrowUp). - Fallback & Suggestion: If the exact name does not exist, the agent refuses to guess and instead suggests the closest real match from the verified catalog.
- Type-Safe Accessor Output: The agent generates typed code references (e.g.,
Image(systemName: String.SFSymbols.squareAndArrowUp)) instead of raw, unverified string literals.
SFSymbolsKit Setup
To verify and compile SF Symbols safely, add the SFSymbolsKit dependency to your Swift package or Xcode project:
.package(url: "https://github.com/WikipediaBrown/SFSymbolsKit.git", from: "1.0.0")
Ensure your AI workspace has access to the local symbol definitions. This is a crucial element when building robust workflows with Openclaw Skills:
# Download the official symbols database to your project root
curl -o path/to/symbols.json https://sfsymbolskit.com/symbols.json
If using an MCP-compatible environment, configure your server to enable resolve_sf_symbol, search_sf_symbols, and sf_symbol_usage tools for immediate validation.
SFSymbolsKit Data Schema & Taxonomy
The skill manages symbol lookup by parsing a structured JSON manifest at {baseDir}/symbols.json containing 7,007 catalog entries.
Manifest Structure
| Property | Type | Description |
|---|---|---|
count |
Integer | Total number of symbols currently indexed in the catalog. |
sfsymbolsVersion |
String | Target version of Apple SFSymbols (e.g., 7.2). |
symbols |
Array | A collection of symbol descriptors. |
Symbol Definition
Each item within the symbols array is defined by:
name: The dotted system name used in Apple API calls (e.g.,square.and.arrow.up).property: The camelCase equivalent accessor mapped within SFSymbolsKit (e.g.,squareAndArrowUp).
SFSymbolsKit Advanced Features
- Model Context Protocol (MCP) Support: Seamlessly prioritizes MCP tools (
resolve_sf_symbol,search_sf_symbols,sf_symbol_usage) to query, analyze, and validate symbols dynamically without manual lookups. - Automatic SPM Injection: Inspects your project directory and automatically inserts the required Swift Package dependency declarations when they are missing.
- Keyword & Digit Translation: Resolves complex edge cases where SF Symbols start with digits or clash with Swift-reserved keywords by utilizing pre-validated properties directly from the source manifest.
SKILL.md
Loading
Related Openclaw Skills
tvs-architect
An expert AI architect skill designed for evidence-based codebase analysis, complex bug root-cause diagnosis, and technical trade-off evaluations.
tvs-deep-interview
An expert requirement analysis skill that guides users through a structured Socratic interview to turn ambiguous ideas into precise, ready-to-execute system specifications.
AIDSO Xiasou GEO Content Generator
An AI-powered Generative Engine Optimization (GEO) tool designed to optimize brand visibility and responses across major conversational AI platforms and search engines.
tvs-verify
A rigorous verification skill that translates user requests into concrete acceptance criteria to prove AI-generated changes actually resolved the root issue.
Medical Literature Search - PubMed
A powerful AI search skill that retrieves and synthesizes medical literature, clinical trials, and drug efficacy studies directly from NCBI PubMed.
TVS Code Reviewer
A deterministic, evidence-driven code auditing skill designed to surface real software flaws with razor-sharp, professional humor without writing code modifications.
Featured*
