How to use Span Claude/Cursor Skill to understand your engineering org

Last updated: February 6, 2026

The Span Skills plugin allows you to query engineering, project management, and investment data from the Span Knowledge Graph directly within Claude Code and Cursor. You can now use the Span Skill to create a shared window into Span in order to ask questions like:

  • “How many PRs did we merge last week?”

  • “What’s our cycle time by team?”

  • “Show deployment frequency trends”

Link to the skill: https://github.com/Attuned-Corp/skills

This article covers:

  1. How to install the Span Skill plugin

  2. How to create a Service Account (so you don’t have to use a PAT and can share across your team

Once you authenticate, you can use it everywhere.

Skills are invoked using the /span:<skill-name> prefix or automatically via natural language.

Available Skills

Skill

Command

Description

ask

/span:ask

Query engineering, project management, and investment data

Supported queries include:

  • Pull requests

  • Cycle time

  • Deployments

  • Epics

  • Issues

  • Sprints

  • Investments

  • Teams

  • DORA metrics

Installation

Claude Code

Option 1: Marketplace (Recommended)

Install directly from within Claude Code:

/plugin marketplace add Attuned-Corp/skills
/plugin install span@span-skills

Or from the terminal:

claude plugin marketplace add Attuned-Corp/skills
claude plugin install span@span-skills

Option 2: Clone and Symlink

For local development or customization:

git clone https://github.com/Attuned-Corp/skills.git ~/span-plugin
ln -s ~/span-plugin ~/.claude/plugins/span

Option 3: Plugin Directory Flag

Load the plugin for a single session:

git clone https://github.com/Attuned-Corp/skills.git ~/span-plugin
claude --plugin-dir ~/span-plugin

Option 4: Git Submodule

For teams who want to pin a specific version:

git submodule add https://github.com/Attuned-Corp/skills.git vendor/span-plugin
claude --plugin-dir vendor/span-plugin

Verifying Installation

After installation, verify the plugin is loaded:

/plugin list

You should see span in the list of installed plugins.

Cursor

Cursor natively supports skills using the same SKILL.md format. Clone the repo and symlink the skills into your project or user-level skills directory:

git clone https://github.com/Attuned-Corp/skills.git ~/span-skills

# Project-level (add to a specific project)
ln -s ~/span-skills/skills/ask .cursor/skills/ask

# Or user-level (available in all projects)
ln -s ~/span-skills/skills/ask ~/.cursor/skills/ask

For more details on how Cursor discovers and invokes skills or alternative methods of installation, see the Cursor Skills documentation.

Usage

Direct Invocation

In Claude Code:

/span:ask

In Cursor, type / followed by the skill name in Agent chat:

/ask

Natural Language (Automatic)

The AI agent automatically activates the skill when you ask relevant questions:

You ask...

What happens

"How many PRs did we merge last week?"

Queries PR count with time filter

"What's the cycle time for the core team?"

Fetches team cycle time metrics

"Who merged the most PRs last month?"

Ranks contributors by PR volume

"Show me deployment frequency trends"

Returns time-series deployment data

"Compare velocity across teams"

Aggregates metrics by team

Prerequisites

To use the span plugin, you need:

  1. A Span account

  2. A Personal Access Token (PAT) from Span

On first use, the skill will guide you through configuration.

Configuration

The plugin stores configuration in ~/.spanrc/ by default:

~/.spanrc/
├── auth.json           # Your token (you create this)
└── metadata-cache.json # API metadata (auto-generated)

To use a custom location, set the SPAN_CONFIG_DIR environment variable:

export SPAN_CONFIG_DIR="/path/to/custom/folder"

About Span

Span is the AI-native engineering intelligence platform that brings clarity to engineering organizations. This plugin brings Span's insights directly into your terminal.

License

MIT License - see LICENSE for details.