agentsclimarketplace
Sign in

Swift semantic indexing workflow

Skill gaelic-ghost/socket/skills/swift-semantic-indexing-workflow

Query Swift types, USRs, documentation, occurrences, references, and relationships with SourceKit, SourceKitten, index stores, and IndexStoreDB. Use for file-local semantics or project-wide symbol questions.From its SKILL.md

Install
npx -y skills add gaelic-ghost/socket --skill swift-semantic-indexing-workflow

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 6 stars6 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as Apache-2.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

3.3 KB, 592 tokens by cl100k_base, as published. Nobody here has run it

Swift Semantic Indexing Workflow

Choose between live file semantics and persisted project-wide index data without substituting syntax shape for type-checked meaning.

Workflow

  1. State the semantic question and required scope:
    • one source snapshot at a byte position
    • one file or module
    • project-wide occurrences and relations
    • documentation or generated interface
  2. Resolve the toolchain that produced or should interpret the source:
    • use Swiftly for matching Swift.org toolchains and cross-platform SwiftPM builds
    • use Xcode's xcrun tools and sourcekitd for Apple SDK or Xcode build settings
    • never load sourcekitd from one toolchain while passing compiler or plugin paths from another
  3. Choose the surface using references/semantic-index-surfaces.md:
    • raw SourceKit for precise live semantic requests
    • SourceKitten for an accepted Swift or JSON convenience layer
    • compiler index store plus IndexStoreDB for project-wide symbols, occurrences, and relations
    • SourceKit-LSP when a standard editor-facing protocol already covers the request
  4. Reconstruct exact compiler arguments from the real build. Include target, SDK, module search paths, language mode, conditional flags, generated sources, bridging inputs, and plugins when applicable.
  5. Keep the source text and position representation paired. Record whether positions are UTF-8 byte offsets, line and column pairs, or LSP positions.
  6. Verify build and index freshness before interpreting missing results.
  7. Normalize output into typed domain records at the integration boundary instead of spreading SourceKit keys or loose JSON dictionaries through the application.
  8. Test absent symbols, overloads, extensions, generated code, conditional compilation, and stale-index behavior.

SourceKitten Policy

  • Treat SourceKitten as a third-party wrapper and CLI around SourceKit, not as the source of semantic truth.
  • Use it when its structure, syntax, doc, index, complete, or raw-request JSON contract matches a concrete integration need.
  • Check installation and toolchain resolution before use; do not assume SourceKitten is bundled with Swiftly or Xcode.
  • Prefer a direct supported library or LSP contract when adding SourceKitten would only translate one unstable representation into another.

Output

Return semantic scope, selected toolchain, selected surface, compiler-argument source, position encoding, index freshness, query result, and uncertainty.

Guardrails

  • Do not answer inferred-type or reference questions from SwiftSyntax alone.
  • Do not treat a missing index result as proof that a symbol is unused before verifying every relevant target was indexed.
  • Do not reuse byte offsets after source text changes.
  • Do not pass machine-local SourceKit or SDK paths into shared package manifests.
  • Do not let raw SourceKit dictionaries become a public application API.

What ships with it: 2 files

2.4 KB alongside SKILL.md

agents/

references/

Keep looking

Skills are one crate of 326,736. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.