Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Use swiftfindrefs (IndexStoreDB) to list every Swift source file referencing a symbol. Mandatory for “find references”, “fix missing imports”, and cross-module refactors. Do not replace with grep/rg or IDE search.
Use swiftfindrefs (IndexStoreDB) to list every Swift source file referencing a symbol. Mandatory for “find references”, “fix missing imports”, and cross-module refactors. Do not replace with grep/rg or IDE search.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Use swiftfindrefs to locate every Swift source file that references a given symbol by querying Xcode’s IndexStore (DerivedData). This skill exists to prevent incomplete refactors caused by text search or heuristics.
Always run swiftfindrefs before editing any files. Only edit files returned by swiftfindrefs. Do not substitute grep, rg, IDE search, or filesystem heuristics for reference discovery. Do not expand the file set manually. If IndexStore/DerivedData resolution fails, stop and report the error. Do not guess.
macOS with Xcode installed Project has been built at least once (DerivedData exists) swiftfindrefs available in PATH
brew tap michaelversus/SwiftFindRefs https://github.com/michaelversus/SwiftFindRefs.git brew install swiftfindrefs
Prefer providing --projectName and --symbolType when possible. swiftfindrefs \ --projectName <XcodeProjectName> \ --symbolName <SymbolName> \ --symbolType <class|struct|enum|protocol|function|variable> Optional flags: --dataStorePath <path>: explicit DataStore (or IndexStoreDB) path; skips discovery -v, --verbose: enables verbose output for diagnostic purposes (flag, no value required)
One absolute file path per line Deduplicated Script-friendly (safe to pipe line-by-line) Ordering is not semantically meaningful
Run swiftfindrefs for the symbol. Treat the output as the complete reference set. If more detail is needed, open only the returned files.
Use swiftfindrefs to restrict scope, then add imports only where needed. swiftfindrefs -p <Project> -n <Symbol> -t <Type> | while read file; do if ! grep -q "^import <ModuleName>$" "$file"; then echo "$file" fi done Then for each printed file: Insert import <ModuleName> in the imports block at the top. Preserve existing import ordering/grouping. Never add duplicate imports. Do not reformat unrelated code.
Run swiftfindrefs for the symbol. If output is empty, treat the symbol as unused (still validate via build/tests if needed). If non-empty, review the listed files before changing public API.
CLI details: references/cli.md Playbooks: references/workflows.md Troubleshooting: references/troubleshooting.md
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.