ashokraj2011/singularityflow/sflow-explain
Claude Code and agent skill by ashokraj2011/singularityflow
- community
Checking that the SKILL.md file is still in the repository.
Explain one change, clause, test, line, gap or generation from cited, deterministic records.
Install
npx vskill@latest install ashokraj2011/singularityflow/sflow-explainSKILL.md
The same SKILL.md was published earlier as ashokraj2011/singularityflow/sflow-explain.
Explain a change from cited records
<!-- sflow-copilot-pause --> Reuse a verified pause-aware entry supplied in this invocation before any mutation or selection change; otherwise first run singularity-flow session current --for-agent --json once; pause precedes Git. If paused: native Copilot, only /sf-pause off, never resume implicitly. Reuse binding/personalization.replyName; fresh operation checks/consent remain required. This skill is already loaded; never call the skill tool for it. Unless paused, continue below in this turn.
<!-- sflow-output-contract: guided-actions --> Output contract: Use read-only CLI evidence, preserve warnings and ordered actions, and change nothing unless explicitly requested. Summarize artifacts with verified Markdown-preview links; never paste document bodies, code or diffs into Copilot. For code, list touched paths and observed added/deleted/created line counts; unavailable stays unavailable. Use existing evidence, not extra calls solely for display. Summaries, links and opened previews are not human review or approval. Never show a person a hash, digest or commit SHA: name the step, its generation, its files. Each action: "<timing> — <label>", then its three separate Markdown bullets, in order: "- Copilot: <copilotCommand>", "- Shell: <command>", "- VS Code (model-free): <modelFreeCommand>". Keep returned routes exact; never apart from their label, on one line or in a table. Missing Copilot: "no verified equivalent"; missing Shell or model-free: "not available for this action". Never invent routes or make more calls for formatting. Run a check only when a returned field or command asks for it; never decide from a step's name, kind or route that it applies. A refusal saying a check does not apply to this step is not a blocker: skip it and continue. Act on a result's act first: its state, do routes and any ask. View each agentOutput.read range and need text file in one response at its exact issued path in .sflow/out/, unless this chat already read that path (same path, same bytes); other omittedFields are optional. A cut-off, empty, running or inaccessible host result uses singularity-flow result last --wait --command "<its words>" --for-agent --json, never a command replay or shell read of the host's copy. Recover read-size/range failures with returned readRequests/readRanges in your file-view tool's parameters; finish all required ranges and continue this task. Use exact pathCorrections; never guess paths. Real missing-file/permission errors retain their path, native error and owner recovery route; never recreate inputs or retry unchanged access. Read taskResume on entry: keep its operation ID, spent budgets and exact next step across chats; obtain fresh context and local paths. Before ending, honor taskCompletion: input reads, preparation and diagnostic tests alone do not complete authoring or review. Preserve human decisions and explicit single-step boundaries. <!-- sflow-execution-boundary --> Boundary: reuse entry ready/workId, cwd=repositoryPath, or as is from a non-Git (chat) folder: SFlow finds the bound checkout; never refuse or wrap for it; CLI/workItemRoot paths only; never $HOME. No duplicate lookup. Use exact CLI-returned paths. repositoryPath is command cwd, not a prefix for absolute file paths. Never rebase paths or strip .git/worktrees. Issued private/external files are exact exceptions to repository confinement, not wider read/write permission; writes still need authorization. Resolve relative paths only against their declared base. On failure, preserve the path and error; never search or recreate it.
- The person typed
/sf-explain $ARGUMENTS, so$ARGUMENTSis their whole request. In the Boundary repository:
- Nothing after
/sf-explain: run nothing and ask what to explain. - A first word of
change,clause,test,line,gaporgenerationis the subject. Run exactly one subject
command: singularity-flow explain --subject <SUBJECT> <REMAINING ARGUMENTS> --for-agent --json. change and gap need nothing more. Never guess a missing --id, --path, --line or --gen; ask the user for the exact value instead.
- Any other word, even one word alone, is a documentation topic or question, so never ask what to explain; answer in
this turn. Run singularity-flow explain '$ARGUMENTS' --for-agent --json, one single-quoted argument with each inner ' as '\'' (PowerShell '') so nothing expands. Answer only from data.served.text, ending with data.citation verbatim. When it returns data.candidates or data.nearest instead, list those topic ids and ask which one. Either result may be bounded: view what its agentOutput lists first.
- For a subject, relay the returned statements with their citation IDs, the
Needs attentionitems, availability reasons, the
authority: none label and the next actions unchanged. When subject.status is ambiguous, list its exact choices and ask which one; when it is unavailable, relay its reason code.
- Stop. Never read or summarize source files yourself, call a clause satisfied, call a change mergeable, treat a
region association or a test tag as proof, infer who wrote a line, or perform any lifecycle mutation.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingplugin/skills/sflow-explain/SKILL.md
Popularity
- 7-day trend score
- 5
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/ashokraj2011/singularityflow/sflow-explain)