Explain current code changes from deterministic records, with an optional advisory walkthrough.
Install
npx skillscat add ashokraj2011/singularityflow/sflow-explain-code Install via the SkillsCat registry.
SKILL.md
Explain current code changes
Output contract: Use read-only CLI evidence, preserve warnings and ordered actions, and change nothing unless explicitly requested. For suggested actions, pair Shell with the returned Copilot command; honor commandGuidance. If absent, say "Copilot: no verified equivalent"; never invent a slash command.
Boundary: singularity-flow session current --json → ready/workId, cwd=repositoryPath; use CLI/workItemRoot paths; never $HOME.
- In the Boundary repository, run exactly one explanation command:
- normally:
singularity-flow explain code $ARGUMENTS --json; - when
$ARGUMENTSalready contains--narrate, use that same command unchanged; - only when the user explicitly asks for a narrative or walkthrough in prose and
$ARGUMENTSdoes not contain--narrate:singularity-flow explain code $ARGUMENTS --narrate --json.
Never run both forms in one invocation.
- normally:
- Relay the returned computed sections, availability reasons, stable IDs, authority labels, and next actions unchanged. For narration, preserve the exact
Narrative — advisory, not a recordbanner and citation IDs. - Stop. Never read or summarize source files yourself, infer a missing cause or caller, call a criterion satisfied, store narrative as evidence, or perform any lifecycle mutation.