Agent skill

Semantic Slicing

by vincentkoc in vincentkoc/dotskills

Build local semantic review slices by combining clawpatch feature maps, deepsec threat candidates, visual review maps, and optional gitcrawl/discrawl evidence for repos such as openclaw/openclaw.

MITAuto-check passed

Install Semantic Slicing

skills CLI
$ npx skills add vincentkoc/dotskills --skill semantic-slicing -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install vincentkoc/dotskills semantic-slicing --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/vincentkoc/dotskills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/semantic-slicing .claude/skills/semantic-slicing && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
semantic-slicing
GitHub stars
107
Token cost
~2k tokens
SKILL.md length
860 words
Files
8 (incl. scripts, references, assets)
Skills in repo
19
Repo updated
First seen
Licence
MIT

At a glance

Build local semantic review slices by combining clawpatch feature maps, deepsec threat candidates, visual review maps, and optional gitcrawl/discrawl evidence for repos such as openclaw/openclaw.

  • Works in 9 steps: Reuse suitable tool state. Create… → Read target repo instructions before… → Verify tool setup → …
  • SKILL.md covers Purpose, When to use, Workflow and Flow, plus 4 more sections
  • Runs JavaScript scripts from its folder

What it does

Semantic Slicing is an agent skill from vincentkoc/dotskills. Build local semantic review slices by combining clawpatch feature maps, deepsec threat candidates, visual review maps, and optional gitcrawl/discrawl evidence for repos such as openclaw/openclaw.

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including scripts, reference files and assets (for example `agents/openai.yaml`, `references/openclaw-profile.md` and `references/slicing-taxonomy.md`).

The repository describes itself as: 🐙 A curated set of Codex and OpenClaw skills for workflow automation, technical debugging, and agent-assisted development patterns. The licence is MIT.

Example prompts

  • “/semantic-slicing”

Requirements

  • Node.js

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. Reuse suitable tool state. Create task-owned temporary storage only when a tool requires files.
  2. Read target repo instructions before scanning. For OpenClaw, read root AGENTS.md; subtree guides matter when reviewing a slice.
  3. Verify tool setup
  4. Run deterministic maps before AI review
  5. Run scripts/semantic-map.mjs to merge the evidence into JSON on stdout.
  6. When a visual board is requested, review it in product order
  7. Choose a cost size before running AI stages
  8. Run AI only at the chosen size
  9. Report retained paths, run IDs, counts, cost size, exclusions, and skipped expensive stages in chat.

What it can do on your machine

Read from SKILL.md and the folder at commit b83ca13. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (JavaScript), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Semantic Slicing loads about 2k tokens when it runs, and up to ~6k if it reads all its reference files. Until then it costs about 53 tokens; SKILL.md has 860 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~53
When it runs · the whole SKILL.md, loaded when a task matches
~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from vincentkoc/dotskills at commit b83ca13, republished under its MIT licence (© vincentkoc). 860 words, ~1,964 tokens.

Download SKILL.mdSave it as .claude/skills/semantic-slicing/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
semantic-slicing
description
Build local semantic review slices by combining clawpatch feature maps, deepsec threat candidates, visual review maps, and optional gitcrawl/discrawl evidence for repos such as openclaw/openclaw.
license
MIT
metadata.source
https://github.com/vincentkoc/dotskills

Semantic Slicing

Purpose

Turn a large repo into reviewable semantic slices with evidence. Use code shape, threat candidates, issue clusters, and support chatter together so review budget lands on the right parts of the system.

Default stance: map locally first, rank second, spend agent/security-review budget last.

When to use

  • Setting up or running openclaw/clawpatch against a target repo.
  • Setting up or running vercel-labs/deepsec against a target repo.
  • Producing a local visual map of feature slices, risky files, ownership clusters, or review targets.
  • Cross-checking code slices against gitcrawl issue/PR data or discrawl Discord/support data.
  • Planning a focused security, regression, architecture, or maintainer-review pass for a large repo.

Workflow

  1. Reuse suitable tool state. Create task-owned temporary storage only when a tool requires files.
  2. Read target repo instructions before scanning. For OpenClaw, read root AGENTS.md; subtree guides matter when reviewing a slice.
  3. Verify tool setup:
    • clawpatch: clone/build openclaw/clawpatch, then run clawpatch init, clawpatch map, clawpatch status.
    • deepsec: clone/build vercel-labs/deepsec, scaffold a scratch workspace, then run deepsec scan.
    • gitcrawl: run gitcrawl doctor --json, then pull clusters/threads for related issue evidence.
    • discrawl: run discrawl doctor --json and discrawl status --json; use search/digest only when support chatter is relevant.
  4. Run deterministic maps before AI review:
    • Clawpatch feature map for entrypoints/packages/config/test slices.
    • Deepsec regex scan for candidate threat surfaces.
    • Optional repo git overlay for CODEOWNERS routing, tracked files, code/test/doc shape, and recent churn.
    • Optional gitcrawl/discrawl lookups for historical pain around the same files, components, or symptoms.
  5. Run scripts/semantic-map.mjs to merge the evidence into JSON on stdout.
    • Select bounded fields for agent inspection. Do not save intermediate output by default.
    • Use --out <path> only for a requested deliverable or required evidence. It retains HTML and JSON by default.
    • Use --format html|json|both to select output. A single format writes only the exact --out path.
    • Sparse mode is on by default and omits dotfile/config trees, docs, changelog files, and mobile app trees so core review stays focused.
    • Use --no-sparse or --sparse false for the full repo; use --sparse-exclude <csv> and --sparse-include <csv> to tune the filter.
  6. When a visual board is requested, review it in product order:
    • review lanes first: semantic shape, ownership routing, development pressure, security pressure, issue pressure, support pressure,
    • focus controls second: lens and system filters that narrow the matrix without duplicating rows,
    • overall lens matrix third: the single slice-row table with comparable bars for semantic, ownership, development, security, issue, and support lenses,
    • agent handoff packet fourth: compact JSON for follow-up agents,
    • evidence tables last: raw-ish overlays for audit, not the primary reading path.
  7. Choose a cost size before running AI stages:
    • low: deterministic maps only; no deepsec process or real clawpatch review.
    • medium: one to three explicit files/features with high-risk slugs, batch size 1, concurrency 1, and a turn cap.
    • high: broader AI processing or multiple feature reviews; requires an explicit budget/time decision.
  8. Run AI only at the chosen size:
    • clawpatch review --feature <id> or a small --limit.
    • deepsec process --files <csv> or tightly scoped --filter plus --only-slugs.
  9. Report retained paths, run IDs, counts, cost size, exclusions, and skipped expensive stages in chat. Remove only task-owned disposable scratch when no longer needed or in use. Preserve named deliverables and recovery evidence.
Show full SKILL.md (326 more words)Show less

Flow

mermaid
stateDiagram-v2
    [*] --> ReadScopeAndInstructions
    ReadScopeAndInstructions --> ReuseToolState
    ReuseToolState --> CreateTemporaryState: required by selected tool
    ReuseToolState --> DeterministicMaps: existing state sufficient
    CreateTemporaryState --> DeterministicMaps
    DeterministicMaps --> MergeEvidence
    MergeEvidence --> ReviewBoard: visual board requested
    MergeEvidence --> ChooseCostSize: inspect stdout map
    ReviewBoard --> ChooseCostSize
    state ChooseCostSize <<choice>>
    ChooseCostSize --> ReportResults: low, no AI processing
    ChooseCostSize --> TargetedAIReview: medium, explicit files and bounded controls
    ChooseCostSize --> BroadAIReview: high, explicit budget and time decision
    ChooseCostSize --> ReportBlocked: required budget or tool unavailable
    TargetedAIReview --> ReportResults
    BroadAIReview --> ReportResults
    ReportResults --> [*]
    ReportBlocked --> [*]

Inputs

  • target_repo: local checkout path and/or GitHub owner/repo.
  • scratch_root: optional task-owned temporary directory for tools that require physical state.
  • out: optional requested deliverable or required evidence path. Omit it for stdout.
  • format: html, json, or both. Default: json without out, otherwise both.
  • clawpatch_repo: local clone of openclaw/clawpatch, optional if clawpatch is already on PATH.
  • deepsec_repo: local clone of vercel-labs/deepsec, optional if deepsec is already on PATH.
  • focus: optional path prefixes, issue numbers, slugs, components, or channels to prioritize.
  • sparse: optional map filter, default true; excludes dotfile/config, docs/changelog, and mobile app paths unless configured.
  • cost_size: low, medium, or high; default low.
  • budget_mode: map-only, targeted-ai, or full-ai; default follows cost_size.

Outputs

  • Tool setup status and blocker list.
  • Clawpatch feature counts and contamination checks.
  • Deepsec scan run ID, candidate counts, top slugs, and top files.
  • Optional repo overlays from --repo: CODEOWNERS routing, tracked files, code/test/doc shape, 90-day churn, and test-gap pressure.
  • Optional gitcrawl cluster/thread evidence and discrawl support evidence.
  • Machine-readable semantic map on stdout by default. Retained HTML and JSON only when requested.
  • Clean semantic buckets, ownership overlay, development overlay, security overlay, issue overlay, support overlay, and normalized queues.
  • Human review lanes, focus controls, agent handoff packet, and ranked next commands per lens with cost-size rationale.

Guardrails

  • Keep generated artifacts out of the target repo unless the user explicitly wants checked-in config.
  • Do not run full deepsec process or broad clawpatch review without an explicit high-cost decision; these can be expensive and noisy.
  • Treat local nested worktrees and dot-agent folders as contamination unless intentionally in scope: .claude/, .codex/, .agents/, .deepsec/, .semantic-slicing/.
  • If a tool maps contaminated paths, post-filter before ranking and call out the upstream limitation.
  • Never paste secrets from scan outputs. Scrub absolute personal paths before external PRs/comments.
  • For OpenClaw, use Testbox/Crabbox only when the task moves from mapping into validation.

References

  • Read references/workflow.md for concrete local setup and run commands.
  • Read references/slicing-taxonomy.md when choosing slice types or map layers.
  • Read references/openclaw-profile.md when the target is openclaw/openclaw.

© vincentkoc, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (scripts, references, assets) in skills/semantic-slicing of vincentkoc/dotskills.

  • SKILL.md
  • agents/openai.yaml
  • assets/icon.jpg
  • references/openclaw-profile.md
  • references/slicing-taxonomy.md
  • references/workflow.md
  • scripts/semantic-map.mjs
  • scripts/semantic-map.test.mjs

Open the folder on GitHubat commit b83ca13

Compare with similar skills

Semantic Slicing next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Semantic Slicing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Semantic Slicing this skillvincentkoc/dotskills107—~2kAutomated safety check: PassMIT
Clawpatchudecode/plate17k—~3.7kAutomated safety check: PassCustom licence
Semantic Liststhedaviddias/Front-End-Checklist74k—~504Automated safety check: PassMIT
Semantic Versioningsickn33/agentic-awesome-skills47k1 repos~2.6kAutomated safety check: PassMIT
Semantic Kernelgithub/awesome-copilot40k1 repos~756Automated safety check: PassMIT
Html5 Semantic Elementsthedaviddias/Front-End-Checklist74k—~449Automated safety check: PassMIT

Similar skills

  • Clawpatch

    udecode/plate

    Operate Clawpatch for semantic feature mapping, automated review, explicit finding fixes, revalidation, reports, and state recovery.

    17k GitHub stars~3.7k tokensUpdated today
    Auto-check passed
  • Semantic Lists

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Use semantic list elements.

    74k GitHub stars~504 tokensUpdated 3 days ago
    Frontend & DesignAuto-check passed
  • Semantic Versioning

    sickn33/agentic-awesome-skills

    Automate versioning and changelog generation using semantic versioning principles.

    47k GitHub starsUsed in 1 repo~2.6k tokens
    DevelopmentAuto-check passed
  • Semantic Kernel

    github/awesome-copilot

    Official

    Create, update, refactor, explain, or review Semantic Kernel solutions using shared guidance plus language-specific references for .NET and Python.

    40k GitHub starsUsed in 1 repo~756 tokens
    DevelopmentAuto-check passed
  • Html5 Semantic Elements

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing templates, rendered HTML, or shared components related to Use semantic HTML elements.

    74k GitHub stars~449 tokensUpdated 3 days ago
    Auto-check passed
  • Vertical Slice

    Donchitos/Claude-Code-Game-Studios

    Pre-production validation — end-to-end build to confirm the full loop is achievable before committing to Production.

    26k GitHub stars~5.2k tokensUpdated yesterday
    Game DevelopmentAuto-check: notes

More from vincentkoc/dotskills

All 19 skills in this repo
  • Openclaw PR Batch Sweep

    vincentkoc/dotskills

    Select, review, repair, validate, and land batches of up to 20 low-risk OpenClaw contributor pull requests using Vincent's maintainer preferences and bounded sub-agent lanes.

    107 GitHub stars~4.1k tokensUpdated yesterday
    Auto-check passed
  • Tmux Agent Lane Orchestrator

    vincentkoc/dotskills

    Monitor and coordinate one tmux agent lane, reconstruct worker state from panes and recent Codex logs, classify progress and blockers, and produce concise manager summaries.

    107 GitHub stars~967 tokensUpdated yesterday
    Auto-check passed
  • Codebase Memory MCP

    vincentkoc/dotskills

    Resolve canonical Git checkouts, index and verify codebase-memory-mcp graphs through the guarded CLI, and safely audit duplicate worktree caches.

    107 GitHub stars~3k tokensUpdated yesterday
    Auto-check passed
  • Org Branch Cleanup

    vincentkoc/dotskills

    Audit and safely prune stale branches across a GitHub organization with immutable snapshots, conservative merged-PR classification, live SHA/protection/open-PR revalidation, resumable deletion…

    107 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • Session Done

    vincentkoc/dotskills

    Prepare a concise session handoff when the user asks to wrap up, capture continuation context, or use /done.

    107 GitHub stars~833 tokensUpdated yesterday
    Auto-check passed
  • Codex Goal Mining

    vincentkoc/dotskills

    Mine structured Codex /goal history locally or across a configured machine fleet, measure active goal time and resumed thread spans, identify unfinished and recurring semantic runs, and turn them…

    107 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed

Questions about Semantic Slicing

What does Semantic Slicing do?

Build local semantic review slices by combining clawpatch feature maps, deepsec threat candidates, visual review maps, and optional gitcrawl/discrawl evidence for repos such as openclaw/openclaw. Semantic Slicing is an agent skill from vincentkoc/dotskills. Build local semantic review slices by combining clawpatch feature maps, deepsec threat candidates, visual review maps, and optional gitcrawl/discrawl evidence for repos such as openclaw/openclaw.

How do I install Semantic Slicing in Claude Code?

Run `npx skills add vincentkoc/dotskills --skill semantic-slicing -a claude-code`. Or copy the skill folder (skills/semantic-slicing in vincentkoc/dotskills) into .claude/skills/semantic-slicing in your project. Claude Code loads it when a task matches its description.

How do I install Semantic Slicing in Codex?

Run `npx skills add vincentkoc/dotskills --skill semantic-slicing -a codex`. Or copy the skill folder (skills/semantic-slicing in vincentkoc/dotskills) into .agents/skills/semantic-slicing in your project. Codex loads it when a task matches its description.

Can I use Semantic Slicing in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vincentkoc/dotskills --skill semantic-slicing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/semantic-slicing, .gemini/skills/semantic-slicing, .github/skills/semantic-slicing and .opencode/skills/semantic-slicing in your project.

What does Semantic Slicing need to run?

Going by SKILL.md and its folder, Semantic Slicing needs JavaScript for the scripts in its folder. Our summary lists: Node.js.

Does Semantic Slicing access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Semantic Slicing safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Semantic Slicing use?

Semantic Slicing is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Semantic Slicing use?

About 2k tokens (SKILL.md is roughly 7.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4k tokens, read only when the agent opens those files.

What are the alternatives to Semantic Slicing?

Skills that share tags, products or a category with Semantic Slicing: Clawpatch (udecode/plate, 17k stars), Semantic Lists (thedaviddias/Front-End-Checklist, 74k stars), Semantic Versioning (sickn33/agentic-awesome-skills, 47k stars) and Semantic Kernel (github/awesome-copilot, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Semantic Slicing?

vincentkoc (a GitHub user) maintains it in vincentkoc/dotskills, which has 107 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 8, 2026.

Source: vincentkoc/dotskills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.