← Back to Skills Marketplace
swiftfindrefs
by
michaelversus
· GitHub ↗
· v1.0.5
1889
Downloads
1
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install swiftfindrefs
Description
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.
Usage Guidance
This skill is coherent and appears to do what it says: run the swiftfindrefs tool and act only on the files it reports. Before installing or running anything: (1) verify the swiftfindrefs binary source (the SKILL suggests a third‑party brew tap on GitHub) — review that repository and its releases; (2) run swiftfindrefs manually on a small project to confirm output; (3) be aware the agent will need local filesystem and command execution rights to read DerivedData and edit source files — grant those only if you trust the tool and environment. If you want extra caution, run the tool yourself and let the agent operate only on its output rather than installing a new binary automatically.
Capability Analysis
Type: OpenClaw Skill
Name: swiftfindrefs
Version: 1.0.5
The skill bundle is designed to use `swiftfindrefs` for Swift code analysis, such as finding symbol references and fixing missing imports. All commands (`brew`, `swiftfindrefs`, `grep`) are directly related to the stated purpose, and the instructions in `SKILL.md` and other documentation files serve as guardrails for the AI agent, ensuring precise and minimal code changes. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, or prompt injection attempts aimed at subverting the agent for harmful objectives. The `brew tap` instruction points to a clear GitHub repository (`https://github.com/michaelversus/SwiftFindRefs.git`) for installation.
Capability Assessment
Purpose & Capability
Name, description, and runtime instructions consistently describe using the swiftfindrefs IndexStoreDB tool to find Swift references. The declared preconditions (macOS, Xcode, DerivedData, swiftfindrefs on PATH) match the stated purpose; no unrelated capabilities or credentials are requested.
Instruction Scope
SKILL.md confines behavior to running swiftfindrefs, interpreting its file-list output, and optionally editing only the returned files (e.g., adding imports). It references DerivedData/IndexStore paths and local file edits — expected for this task. There are no instructions to read unrelated system files, send data to external endpoints, or access secrets.
Install Mechanism
The skill is instruction-only and does not perform an automated install. The README suggests using a brew tap pointing at a third‑party GitHub repo (michaelversus/SwiftFindRefs). That is a plausible install route, but because the tap is third‑party you should inspect the repository or prefer an official release before running brew tap/install.
Credentials
No environment variables, credentials, or config paths are declared or required. The skill implicitly requires filesystem and command execution access (to read DerivedData, run swiftfindrefs, and edit returned source files), which is proportionate to its purpose.
Persistence & Privilege
The skill is not forced always-on (always: false) and does not request persistent elevated privileges or modify other skills. Model invocation is allowed (the platform default) and appropriate for a user-invocable tooling skill.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install swiftfindrefs - After installation, invoke the skill by name or use
/swiftfindrefs - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.5
- Added installation instructions using Homebrew for swiftfindrefs.
- Updated optional argument: replaced --derivedDataPath with --dataStorePath for specifying IndexStoreDB location.
v1.0.4
- Initial documentation added with clear description, rules, canonical command, output expectations, and standard workflows for using swiftfindrefs.
- Emphasizes that swiftfindrefs must be used instead of grep, rg, or IDE search for finding Swift symbol references.
- Provides example commands and step-by-step instructions for common workflows: finding references, fixing missing imports, and usage audits before deleting/renaming.
- Lists strict rules for file editing and error handling to ensure accurate and reproducible results.
Metadata
Frequently Asked Questions
What is swiftfindrefs?
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. It is an AI Agent Skill for Claude Code / OpenClaw, with 1889 downloads so far.
How do I install swiftfindrefs?
Run "/install swiftfindrefs" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is swiftfindrefs free?
Yes, swiftfindrefs is completely free (open-source). You can download, install and use it at no cost.
Which platforms does swiftfindrefs support?
swiftfindrefs is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created swiftfindrefs?
It is built and maintained by michaelversus (@michaelversus); the current version is v1.0.5.
More Skills