security-ownership-map

Analyze git history to build contributor-file graphs for security ownership assessment.

Updated Jul 6, 2026
One-click install
npx skills add https://github.com/shirulot/codex-skill --skill security-ownership-map-shirulot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: security-ownership-map
Source: https://github.com/shirulot/codex-skill/tree/main/security-ownership-map
Command: npx skills add https://github.com/shirulot/codex-skill --skill security-ownership-map-shirulot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires networkx, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This skill addresses the lack of visibility into who actually maintains sensitive code, identifying orphaned security-critical files and highlighting bus-factor risks where knowledge is concentrated in too few individuals.

Core Features & Use Cases

  • Ownership Topology: Builds a bipartite graph of people and files based on git commit history to visualize who touches what.
  • Risk Analysis: Automatically flags sensitive hotspots (auth, crypto, secrets) with low bus factors and identifies stale, orphaned code.
  • Use Case: Security teams can use this to perform reality checks on CODEOWNERS files, ensuring that the people listed as owners are actually the ones actively maintaining the code.

Quick Start

Run the security ownership map script on the current repository to generate a full security risk report and ownership graph.

Frequently Asked Questions about security-ownership-map

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I map git history to identify security ownership and bus factor risks?

Mapping git history to identify security ownership involves analyzing commit data to build a bipartite graph of contributors and files. This process calculates bus factor metrics and flags sensitive code hotspots where maintenance knowledge is concentrated in too few individuals.

What is a bipartite graph and how does it assess code ownership?

A bipartite graph for code ownership assessment maps contributors to files based on git history. It visually represents who touches what, allowing you to perform reality checks on CODEOWNERS files and identify orphaned security-critical files.

Do I need Python 3 and networkx to analyze sensitive code hotspots?

Yes, analyzing sensitive code hotspots requires Python 3 and the networkx library. These dependencies are necessary to construct the ownership graph, perform community detection, and execute ownership clustering algorithms.

How do I generate a security risk report for orphaned security-critical files?

To generate a security risk report for orphaned files, run the security ownership analysis script on your repository. It automatically flags sensitive hotspots like auth and crypto code with low bus factors and identifies stale code.

Can I export the git ownership graph for visualization in Neo4j?

Yes, you can export the git ownership graph for visualization in Neo4j. The analysis generates graph artifacts from the repository history that are compatible with visualization tools like Neo4j to explore contributor and file relationships.

What's the best way to validate CODEOWNERS files against actual git commit activity?

The best way to validate CODEOWNERS files against actual activity is comparing them against a bipartite ownership graph. This graph is built from actual git commit history to verify that listed owners are actively maintaining the code.