SY

syspilot.impact-python

Analyzes technical specification links to determine the impact of changes across a system.

Install

mkdir -p .claude/skills/syspilot-impact-python && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/10202" && unzip -o skill.zip -d .claude/skills/syspilot-impact-python && rm skill.zip

Installs to .claude/skills/syspilot-impact-python

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Impact analysis using sphinx-needs dependency trees. Discovers affected specification elements by traversing traceability links. USE FOR: change scoping, blast radius analysis, element discovery before spec writing.
215 chars✓ has a “when” trigger
Advanced

Key capabilities

  • →Traverse traceability links
  • →Find affected specification elements
  • →Analyze blast radius
  • →Query consumer/producer relationships

How it works

It traverses sphinx-needs dependency trees to discover elements affected by a proposed change.

Inputs & outputs

You give it
Change request
You get back
Affected elements list

When to use syspilot.impact-python

  • →Determine change impact
  • →Analyze blast radius of code changes
  • →Discover linked specification elements
  • →Validate documentation dependencies

About this skill

Impact Analysis

Tool

Run .github/skills/syspilot.impact-python/scripts/get_need_links.py --help for the complete CLI.

python .github/skills/syspilot.impact-python/scripts/get_need_links.py NEED_ID --direction both --depth 2

The default inputs are:

  • active ontology: the literal needs_from_toml string in docs/conf.py, resolved relative to that configuration file;
  • built per-ID Needs data: docs/_build/html/needs_id/.

Use --ontology or --needs-dir to override these inputs. Configuration is inspected without executing it; use --ontology when needs_from_toml is computed rather than a literal string. Missing or invalid bindings fail explicitly. The tool attempts a Sphinx HTML build when default Needs data is absent; use --no-build when the caller must control that prerequisite.

Traversal

The tool reads every option declared by the active ontology's [[needs.extra_links]]. It traverses each <option> and <option>_back field in addition to standard links and links_back, so customer-defined link types work without code changes.

  • --direction out follows outgoing fields.
  • --direction in follows incoming *_back fields.
  • --direction both follows both.
  • --depth N bounds traversal depth.
  • --flat returns sorted unique linked IDs.
  • --simple returns direct incoming and/or outgoing IDs plus metadata.
  • --typed returns relationship pairs with source, target, option, direction, and discovery depth for analyzers such as Trace.
  • Default output is a nested tree with cycle/repeated-node truncation.

Typed output is opt-in; without it, the existing nested, flat, and simple formats are unchanged. IDs reached through multiple link options are de-duplicated. Cycles do not recurse indefinitely.

Contract Use

Run impact analysis from existing elements whose relationships can expose affected work. Query output supplies candidate scope and traceability evidence to the applicable Contract. The Contract records the disposition of each candidate and remains authoritative for included artifacts, responsibility, and scope decisions.

Do not treat an empty or failed query as authoritative evidence. The command exits non-zero for an unknown Need, missing or invalid ontology, missing built Needs data, or an unusable build prerequisite. Resolve the reported prerequisite before recording impact conclusions.

Verification

Release QA is maintained in Syspilot's repository test suite, outside the installed skill folder.

When not to use it

  • →When the sphinx-needs documentation is stale

Prerequisites

sphinx-needs documentation

Limitations

  • →Requires sphinx-build to be run
  • →Requires valid traceability links

How it compares

It automates impact analysis based on formal traceability links, rather than manual dependency tracking.

Compared to similar skills

syspilot.impact-python side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
syspilot.impact-python (this skill)05moReviewAdvanced
deepwiki-rs251yReviewIntermediate
cc-skill-project-guidelines-example19moReviewBeginner
mcp-builder1366moReviewAdvanced

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry