Agent skill

Gossiphs

by williamfzc in williamfzc/gossiphs

A skill your agent uses when you need to find related files, understand code dependencies, or analyze impact scope.

Apache-2.0Auto-check passedDevelopment

Install Gossiphs

skills CLI
$ npx skills add williamfzc/gossiphs --skill gossiphs -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install williamfzc/gossiphs gossiphs --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/williamfzc/gossiphs.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/gossiphs .claude/skills/gossiphs && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
gossiphs
GitHub stars
102
Token cost
~702 tokens
SKILL.md length
160 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when you need to find related files, understand code dependencies, or analyze impact scope.

  • You need to find related files
  • SKILL.md covers Prerequisites, Core Command, Usage Patterns and Parameters, plus 2 more sections
  • Calls jq
  • Understand code dependencies

What it does

Gossiphs is an agent skill from williamfzc/gossiphs. Use when you need to find related files, understand code dependencies, or analyze impact scope. Triggers when the user asks about: - "Which files use this function/class?" - "What files will be affected if I change this?" - "Find code related to X" - "What does this file depend on?" - "Where is this symbol defined/referenced?" Uses gossiphs binary directly (no MCP required).

Its SKILL.md is about 700 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. It works with Model Context Protocol and Python. The repository describes itself as: "Zero setup" & "Blazingly fast" general code file relationship analysis. With Python & Rust. Based on tree-sitter and git analysis. Support skill and ready for AI🤖. The licence is Apache-2.0.

When your agent uses it

  • You need to find related files
  • Understand code dependencies
  • Analyze impact scope

Example prompts

  • “Which files use this function/class?”
  • “What files will be affected if I change this?”
  • “Find code related to X”
  • “/gossiphs”

What it can do on your machine

Read from SKILL.md and the folder at commit efe82f1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • jq

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Gossiphs loads about 702 tokens when it runs. Until then it costs about 97 tokens; SKILL.md has 160 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~97
When it runs · the whole SKILL.md, loaded when a task matches
~702

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from williamfzc/gossiphs at commit efe82f1, republished under its Apache-2.0 licence (© williamfzc). 160 words, ~702 tokens.

Download SKILL.mdSave it as .claude/skills/gossiphs/SKILL.md (or your agent's skills folder).
name
gossiphs
description
Use when you need to find related files, understand code dependencies, or analyze impact scope. Triggers when the user asks about: - "Which files use this function/class?" - "What files will be affected if I change this?" - "Find code related to X" - "What does this file depend on?" - "Where is this symbol defined/referenced?" Uses gossiphs binary directly (no MCP required).

Code Relations

Quickly discover file relationships in a codebase using semantic analysis.

Prerequisites

Ensure gossiphs binary is available:

bash
which gossiphs || echo "Install: cargo install gossiphs"

Core Command

bash
gossiphs relate --file <PATH> [--json]

Output is JSON array with:

  • name: source file
  • related[]: related files with name, score, refs, defs, related_symbols

Usage Patterns

bash
gossiphs relate --file src/auth/login.rs | jq '.[0].related[].name'
bash
gossiphs relate --file src/lib.rs | jq '.[0].related | sort_by(-.score) | .[0:5][] | {name, score}'
Find shared symbols between files
bash
gossiphs relate --file src/lib.rs | jq '.[0].related[] | select(.name | contains("auth")) | .related_symbols[].symbol.name' | sort -u
Impact analysis for a file change
bash
gossiphs relate --file <FILE> | jq '.[0].related[] | "\(.name) (score: \(.score), refs: \(.refs))"'

Parameters

FlagDescription
-p, --project-pathProject root (default: .)
--fileTarget file to analyze
--depthGit history depth (default: 100)
--strictPrecise-first analysis
--exclude-file-regexExclude files matching pattern

Example Scenarios

Scenario 1: Impact Analysis

User: "I want to refactor User class. What should I check?"

1. gossiphs relate --file src/models/user.py
2. Parse JSON output for related files
3. Report: "These files reference User symbols and may need updates..."
Scenario 2: Find implementation

User: "Where is the authentication logic?"

1. Start from known entry: gossiphs relate --file src/routes/auth.rs
2. Follow related files to trace the flow
3. Report: "Auth flow: routes/auth.rs -> middleware/jwt.rs -> services/auth.rs"
Scenario 3: Dependency discovery

User: "What does payment module depend on?"

1. gossiphs relate --file src/payment/
2. List incoming/outgoing connections
3. Summarize dependency graph

Tips

  • First run may be slow - builds index from git history
  • Subsequent runs are fast - cached in .gossiphs/
  • Semantic over textual - connections based on symbol semantics
  • Git history matters - files changed together get stronger connections

© williamfzc, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/gossiphs of williamfzc/gossiphs.

Open the folder on GitHubat commit efe82f1

Compare with similar skills

Gossiphs next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Gossiphs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gossiphs this skillwilliamfzc/gossiphs102—~702Automated safety check: PassApache-2.0
LangBot Plugin Developmentlangbot-app/LangBot18k—~3.9kAutomated safety check: PassApache-2.0
LangBot Core Developmentlangbot-app/LangBot18k—~1.4kAutomated safety check: NotesApache-2.0
Drawio Diagram BuilderWill-hxw/drawio-diagram-builder413—~5.9kAutomated safety check: PassMIT
MCP Debuggerdebugmcp/mcp-debugger172—~3.8kAutomated safety check: PassMIT
Ue Live DebuggingJasonMa0012/MooaToon750—~2.9kAutomated safety check: NotesCustom licence

Similar skills

  • LangBot Plugin Development

    langbot-app/LangBot

    Guides building, debugging and testing LangBot plugins: components, SDK calls, README and locale rules, SDK pitfalls and WebSocket-based testing.

    18k GitHub stars~3.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • LangBot Core Development

    langbot-app/LangBot

    Covers developing the LangBot core backend and web UI: dev setup, repo layout, API auth types, adding endpoints, migrations and keeping the MCP server in step.

    18k GitHub stars~1.4k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Drawio Diagram Builder

    Will-hxw/drawio-diagram-builder

    Create, edit, replicate, and iteratively refine editable research and technical diagrams in diagrams.net/draw.io (.drawio XML) from prompts, papers, repositories, screenshots, or existing diagrams.

    413 GitHub stars~5.9k tokensUpdated 3 mo ago
    DevelopmentAuto-check passed
  • MCP Debugger

    debugmcp/mcp-debugger

    A skill your agent uses when investigating a bug, failing test, or unexpected runtime behavior and the mcp-debugger MCP server is available — drives real step-through debuggers (breakpoints, stack…

    172 GitHub stars~3.8k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Ue Live Debugging

    JasonMa0012/MooaToon

    A skill your agent uses when debugging UE C++ crashes, runtime bugs, or unexpected behavior with Rider MCP available.

    750 GitHub stars~2.9k tokensUpdated 21 days ago
    DevelopmentAuto-check: notes
  • Agentloom Framework Skill

    linora-u/AgentLoom

    当用户需要理解、开发、扩展或验证 AgentLoom 框架能力时使用。覆盖创建/扩展 Application、设计单 Agent 或多 Agent、编写 Agent/Worker YAML、实现 Tool、创建私有 Skill 或 Hook、更新 README、验证 YAML/结构/运行结果。也适用于用户问“这个功能用 AgentLoom 怎么实现”。

    168 GitHub stars~2.1k tokensUpdated today
    DevelopmentAuto-check passed

Questions about Gossiphs

What does Gossiphs do?

A skill your agent uses when you need to find related files, understand code dependencies, or analyze impact scope. Gossiphs is an agent skill from williamfzc/gossiphs. Use when you need to find related files, understand code dependencies, or analyze impact scope.

When should I use Gossiphs?

Gossiphs fits situations like: you need to find related files; understand code dependencies; analyze impact scope.

How do I install Gossiphs in Claude Code?

Run `npx skills add williamfzc/gossiphs --skill gossiphs -a claude-code`. Or copy the skill folder (skills/gossiphs in williamfzc/gossiphs) into .claude/skills/gossiphs in your project. Claude Code loads it when a task matches its description.

How do I install Gossiphs in Codex?

Run `npx skills add williamfzc/gossiphs --skill gossiphs -a codex`. Or copy the skill folder (skills/gossiphs in williamfzc/gossiphs) into .agents/skills/gossiphs in your project. Codex loads it when a task matches its description.

Can I use Gossiphs in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add williamfzc/gossiphs --skill gossiphs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gossiphs, .gemini/skills/gossiphs, .github/skills/gossiphs and .opencode/skills/gossiphs in your project.

What does Gossiphs need to run?

Going by SKILL.md and its folder, Gossiphs needs the command-line tools its instructions call (jq).

Does Gossiphs access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Gossiphs safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Gossiphs use?

Gossiphs is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gossiphs use?

About 702 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Gossiphs?

Skills that share tags, products or a category with Gossiphs: LangBot Plugin Development (langbot-app/LangBot, 18k stars), LangBot Core Development (langbot-app/LangBot, 18k stars), Drawio Diagram Builder (Will-hxw/drawio-diagram-builder, 413 stars) and MCP Debugger (debugmcp/mcp-debugger, 172 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gossiphs?

williamfzc (a GitHub user) maintains it in williamfzc/gossiphs, which has 102 GitHub stars. The repository was last updated on March 28, 2026.

Source: williamfzc/gossiphs on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.