# Software Slice Selection

Mark the just-completed slice or slice batch (if any), update the completed slices...

- Repository: https://github.com/stencila/stencila (914 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add stencila/stencila --skill software-slice-selection -g -a claude-code -y`
Codex: `npx skills add stencila/stencila --skill software-slice-selection -g -a codex -y`
Cursor: `npx skills add stencila/stencila --skill software-slice-selection -g -a cursor -y`
Gemini CLI: `npx skills add stencila/stencila --skill software-slice-selection -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add stencila/stencila`

## Description

Mark the just-completed slice or slice batch (if any), update the completed slices list, select the next unfinished execution unit from a delivery plan based on phase ordering and dependency constraints, and report whether more slices remain. Determines slice exhaustion, not full plan completion, does not verify plan-level Definition of Done items. Combines completion tracking with next-work selection in a single step. Reads plans from .stencila/plans/, parses phase and slice structure, validates package references against the codebase, and can normalize overly narrow plan slices by combining adjacent compatible slices into one execution unit.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## Overview

Mark the just-completed slice or slice batch (if any), update the completed slices list, and select the next unfinished execution unit from a software delivery plan stored in `.stencila/plans/`. Given a just-finished slice name and a list of already-completed slices, append the finished slice or slices, identify the next unit of work to execute based on phase ordering and dependency constraints, validate its package references against the codebase, and report the unit details along with the updated completed list. If all slices are complete, report that no slices remain.

This skill determines **slice exhaustion**, whether there are more execution slices to select, not full plan completion. Many plans include a `## Definition of Done` section with plan-level closure checks (e.g., all tests passing, linting clean, generated types updated, documentation complete). This skill does not evaluate those checks. When all slices have been selected and completed, the skill reports that no slices remain, but the caller must verify Definition of Done items separately before treating the plan as finished.

This skill reads a plan file, parses its structure, tracks completions, and determines what comes next. It does not write code, create tests, modify the plan, or manage any external state beyond reporting its findings. It also acts as a normalizer of planning granularity: plan-authored slices are advisory, and the selected execution unit may consist of one slice or several adjacent compatible slices when that would reduce workflow overhead without creating an unmanageably broad TDD loop.

## Required Inputs

The rest: https://github.com/stencila/stencila/blob/HEAD/.stencila/skills/software-slice-selection/SKILL.md
