detect-release-scope

Analyze git changes to classify release scope as marketplace, plugin, or variants.

Updated Dec 29, 2025
One-click install
npx skills add https://github.com/jayteealao/Aperture --skill detect-release-scope
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: detect-release-scope
Source: https://github.com/jayteealao/Aperture/tree/main/.claude/skills/detect-release-scope
Command: npx skills add https://github.com/jayteealao/Aperture --skill detect-release-scope

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill analyzes git changes (modified, staged, and untracked files) to intelligently determine which release scope should be targeted: marketplace-level, per-plugin, or variants. This helps automate and de-risk release workflows by ensuring the correct versioning context is used.

Core Features & Use Cases

  • Scope classification: Inspect changed paths and decide between marketplace, plugin-specific, or variant releases.
  • Primary scope determination: Apply dominance rules to pick a single scope when possible, or report ambiguity with counts.
  • Output and guidance: Produce structured output with the identified scope, per-scope evidence, current branch, and warnings to guide publishing decisions.

Quick Start

Use the detect-release-scope skill in a Git repository with pending changes to determine the recommended release target.

Frequently Asked Questions about detect-release-scope

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

FAQPage Schema
How do I determine the correct release scope from git changes?

To determine release scope from git changes, analyze modified, staged, untracked, and deleted file paths. This classifies changes into marketplace, plugin-specific, or variant scopes, applying dominance rules to pick a single scope or report ambiguity with counts.

What is the best way to automate marketplace versus plugin release targeting?

Automating marketplace versus plugin release targeting requires inspecting git changes and applying dominance rules to classify the primary scope. This produces structured output with per-scope evidence and warnings to guide publishing decisions without manual path inspection.

Can I use git workflow analysis to detect variants release scope?

Yes, you can use git workflow analysis to detect variants release scope. By examining modified, staged, and untracked file paths, the analysis classifies whether changes fall under variants, marketplace, or plugin-specific contexts for accurate versioning.

Do I need external dependencies to analyze git changes for release scope?

No, you do not need external dependencies to analyze git changes for release scope. The process operates using standard git tooling, evaluating modified and untracked files to output the classified scope, current branch, and relevant warnings.

How does scope classification handle ambiguous git changes across multiple directories?

Scope classification handles ambiguous git changes by applying dominance rules to select a primary scope when possible. When multiple directories are affected, it reports ambiguity with counts and provides warnings to guide your publishing decisions.