Skip to content
Back to search

dotskills

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/vincentkoc/dotskills with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/vincentkoc/dotskills'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/vincentkoc--dotskills/badge.svg)](/listings/vincentkoc--dotskills)

HTML

<a href="/listings/vincentkoc--dotskills"><img src="/api/listings/vincentkoc--dotskills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Install one skill:

npx skills add vincentkoc/dotskills --skill ghcrawl-cluster-operator -y
npx skills add vincentkoc/dotskills --skill agent-device-lab -y
npx skills add vincentkoc/dotskills --skill codebase-memory-mcp -y
npx skills add vincentkoc/dotskills --skill codex-goal-mining -y
npx skills add vincentkoc/dotskills --skill codex-session-recovery -y
npx skills add vincentkoc/dotskills --skill crabpot-perf-metrics -y
npx skills add vincentkoc/dotskills --skill technical-deslop -y
npx skills add vincentkoc/dotskills --skill technical-documentation -y
npx skills add vincentkoc/dotskills --skill session-done -y
npx skills add vincentkoc/dotskills --skill technical-integrations -y
npx skills add vincentkoc/dotskills --skill technical-skill-finder -y
npx skills add vincentkoc/dotskills --skill openclaw-github-dedupe -y
npx skills add vincentkoc/dotskills --skill openclaw-pr-batch-sweep -y
npx skills add vincentkoc/dotskills --skill org-branch-cleanup -y
npx skills add vincentkoc/dotskills --skill openclaw-bun-upgrade -y
npx skills add vincentkoc/dotskills --skill operations-worktree -y
npx skills add vincentkoc/dotskills --skill crawlkit -y
npx skills add vincentkoc/dotskills --skill graincrawl -y
npx skills add vincentkoc/dotskills --skill github-airplane-mode -y
npx skills add vincentkoc/dotskills --skill semantic-slicing -y
npx skills add vincentkoc/dotskills --skill tmux-agent-lane-orchestrator -y
npx skills add vincentkoc/dotskills --skill tmux-lane-orchestrator -y

List available public skills:

npx skills add vincentkoc/dotskills --list

`github-airplane-mode` requires an already-installed compatible `low-data` command. Installing the skill does not install a network guard or change its mode.

Default sync targets are managed automatically by vercel skills.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 144 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "dotskills",
  3. "owner": {
  4. "name": "vincentkoc"
  5. },
  6. "metadata": {
  7. "description": "A .skills collection: prompts with resources and scripts as reusable AI runtime modules.",
  8. "version": "1.0.0"
  9. },
  10. "plugins": [
  11. {
  12. "name": "agent-device-lab",
  13. "source": "./skills/agent-device-lab",
  14. "skills": "./",
  15. "description": "Prepare a Mac and one physical Android or iPhone for an authorized test."
  16. },
  17. {
  18. "name": "codebase-memory-mcp",
  19. "source": "./skills/codebase-memory-mcp",
  20. "skills": "./",
  21. "description": "Bring up `codebase-memory-mcp` for the owning Git checkout and prove the graph is usable before relying on it for code discovery. Keep linked worktrees on the owner's graph instead of creating one graph per branch."
  22. },
  23. {
  24. "name": "codex-goal-mining",
  25. "source": "./skills/codex-goal-mining",
  26. "skills": "./",
  27. "description": "Recover structured Codex goal history and convert free-form runs into evidence-backed, repeatable suites."
  28. },
  29. {
  30. "name": "codex-session-recovery",
  31. "source": "./skills/codex-session-recovery",
  32. "skills": "./",
  33. "description": "Recover crashed, detached, or confusing agent sessions while preserving the best restore source."
  34. },
  35. {
  36. "name": "crabpot-perf-metrics",
  37. "source": "./skills/crabpot-perf-metrics",
  38. "skills": "./",
  39. "description": "Turn Crabpot/OpenClaw perf artifacts into a clear read: what changed, what is real signal, what is stale/noisy, and what action is worth taking."
  40. },
  41. {
  42. "name": "crawlkit",
  43. "source": "./skills/crawlkit",
  44. "skills": "./",
  45. "description": "Maintain crawlkit, the shared Go library for crawl app archive infrastructure."
  46. },
  47. {
  48. "name": "ghcrawl-cluster-operator",
  49. "source": "./skills/ghcrawl-cluster-operator",
  50. "skills": "./",
  51. "description": "Operate ghcrawl as a local-first GitHub issue and pull request crawler: inspect the SQLite store, pull GitHub data, refresh summaries and embeddings, build clusters, and extract cluster evidence through deterministic CLI commands."
  52. },
  53. {
  54. "name": "github-airplane-mode",
  55. "source": "./skills/github-airplane-mode",
  56. "skills": "./",
  57. "description": "Switch an already-installed local Git and GitHub download guard."
  58. },
  59. {
  60. "name": "graincrawl",
  61. "source": "./skills/graincrawl",
  62. "skills": "./",
  63. "description": "Maintain `graincrawl`, the Go CLI that archives Granola notes, transcripts,"
  64. },
  65. {
  66. "name": "openclaw-bun-upgrade",
  67. "source": "./skills/openclaw-bun-upgrade",
  68. "skills": "./",
  69. "description": "Move an authorized Linux OpenClaw service to one verified Bun artifact while preserving"
  70. },
  71. {
  72. "name": "openclaw-github-dedupe",
  73. "source": "./skills/openclaw-github-dedupe",
  74. "skills": "./",
  75. "description": "Use this skill when a cluster of GitHub issues and pull requests has been reported for a common failure mode (Slack, iMessage, support threads, or manual list), and you need an evidence-based dedupe recommendation, execution pass, or autonomous closeout run."
  76. },
  77. {
  78. "name": "openclaw-pr-batch-sweep",
  79. "source": "./skills/openclaw-pr-batch-sweep",
  80. "skills": "./",
  81. "description": "Drive a continuing queue of real, low-risk OpenClaw contributor bug fixes through qualification, repair, proof, and landing. Work in batches of up to 20 without padding the batch with micro-patches, speculative cleanup, or risky surfaces."
  82. },
  83. {
  84. "name": "operations-worktree",
  85. "source": "./skills/operations-worktree",
  86. "skills": "./",
  87. "description": "Create and manage worktrees safely and consistently across projects while avoiding stale branch bases."
  88. },
  89. {
  90. "name": "org-branch-cleanup",
  91. "source": "./skills/org-branch-cleanup",
  92. "skills": "./",
  93. "description": "Remove organization branch clutter without guessing which refs are safe to delete."
  94. },
  95. {
  96. "name": "semantic-slicing",
  97. "source": "./skills/semantic-slicing",
  98. "skills": "./",
  99. "description": "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."
  100. },
  101. {
  102. "name": "session-done",
  103. "source": "./skills/session-done",
  104. "skills": "./",
  105. "description": "Capture the outcome, evidence, unresolved work, and next action without making session completion a cleanup or memory-write command."
  106. },
  107. {
  108. "name": "technical-deslop",
  109. "source": "./skills/technical-deslop",
  110. "skills": "./",
  111. "description": "Clean branch/staged diffs by removing AI-style slop and restoring repo-consistent style without changing behavior."
  112. },
  113. {
  114. "name": "technical-documentation",
  115. "source": "./skills/technical-documentation",
  116. "skills": "./",
  117. "description": "Produce, review, and audit technical documentation that is clear, unambiguous, and maintainable for both humans and agents. Covers product docs, contributor-governance files, and agent instruction files. Prose follows Simplified Technical English so a reader or an agent cannot misread it. Audits scale to trees with hundreds of pages through sharding, adversarial checks, and parallel remediation."
  118. },
  119. {
  120. "name": "technical-integrations",
  121. "source": "./skills/technical-integrations",
  122. "skills": "./",
  123. "description": "Design and review external-vendor integrations using existing internal patterns, with vendor/framework-agnostic workflows for API, RFC, SDK, and rollout planning."
  124. },
  125. {
  126. "name": "technical-skill-finder",
  127. "source": "./skills/technical-skill-finder",
  128. "skills": "./",
  129. "description": "Find recurring pain points from local agent logs and convert them into actionable skill candidates, reuse opportunities, or existing skill updates."
  130. },
  131. {
  132. "name": "tmux-agent-lane-orchestrator",
  133. "source": "./skills/tmux-agent-lane-orchestrator",
  134. "skills": "./",
  135. "description": "Turn a tmux window of coding-agent workers into a visible, auditable lane with clear state and next actions."
  136. },
  137. {
  138. "name": "tmux-lane-orchestrator",
  139. "source": "./skills/tmux-lane-orchestrator",
  140. "skills": "./",
  141. "description": "Act as the manager for one tmux worker lane. Keep visibility over the lane's panes, infer what each worker is doing from tmux and Codex logs, surface blockers, and give the operator short status summaries with concrete next actions."
  142. }
  143. ]
  144. }
README.md · README · 211 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. ![.skills banner](.assets/banner.jpg)
  3. # .skills (dotskills)
  4. [![CI](https://img.shields.io/github/actions/workflow/status/vincentkoc/dotskills/validate.yml?event=pull_request&label=CI)](https://github.com/vincentkoc/dotskills/actions/workflows/validate.yml)
  5. [![Release](https://img.shields.io/github/actions/workflow/status/vincentkoc/dotskills/release.yml?label=Release)](https://github.com/vincentkoc/dotskills/actions/workflows/release.yml)
  6. [![Verify installs](https://img.shields.io/github/actions/workflow/status/vincentkoc/dotskills/verify-install.yml?label=Install%20verify)](https://github.com/vincentkoc/dotskills/actions/workflows/verify-install.yml)
  7. [![CodeQL](https://img.shields.io/github/actions/workflow/status/vincentkoc/dotskills/codeql.yml?branch=main&label=CodeQL)](https://github.com/vincentkoc/dotskills/actions/workflows/codeql.yml)
  8. [![License](https://img.shields.io/github/license/vincentkoc/dotskills?label=License)](LICENSE)
  9. [![Latest tag](https://img.shields.io/github/v/tag/vincentkoc/dotskills?label=Release)](https://github.com/vincentkoc/dotskills/tags)
  10. [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
  11. </div>
  12. We are moving from "prompt as text" to **skill as runtime module**. Each skill acts like a lightweight, containerized application for AI work: a stable interface, opinionated workflow, and bundled resources that can be installed, versioned, tested, and reused across projects.
  13. ## How this repo works
  14. This is my personal **.skills** repository for Codex, Cursor, OpenClaw and agent-first tooling. `.skills` is the dotfiles mindset applied to AI execution: instead of one-off prompts, this repo stores reusable skill units that bundle:
  15. - prompt logic (`SKILL.md` / `AGENT.md` / `AGENTS.md`)
  16. - references and knowledge assets
  17. - scripts for deterministic execution
  18. - repeatable validation + publishing workflows
  19. - support external skills through submodules
  20. - git managed personal registry and github action hooks
  21. ## Configuration ownership
  22. Keep each configuration with the component that installs and validates it:
  23. | Configuration | Owner |
  24. |---|---|
  25. | Reusable skills, references, and bundled helpers | This repository |
  26. | Personal global agent instructions | [dotfiles `.codex/AGENTS.md`](https://github.com/vincentkoc/dotfiles/blob/master/.codex/AGENTS.md) |
  27. | Repository-specific `AGENTS.md` instructions | The repository they govern |
  28. | MCP registrations, machine-local settings, and credential injection | The platform's dotfiles/bootstrap installer |
  29. `make sync` selects agent targets such as `codex` and `cursor`. It installs
  30. skills and the supported slash-command prompts; it does not render repository
  31. instructions or MCP configuration. Use the platform installer to reconcile a
  32. machine's MCP setup, and keep credentials out of skill packages. This avoids a
  33. second configuration generator competing with those owners.
  34. ## Public skills
  35. | Skill | What it does | Install |
  36. |---|---|---|
  37. | `codebase-memory-mcp` | Index canonical Git checkouts through a guarded CLI and audit duplicate worktree caches. | `npx skills add vincentkoc/dotskills --skill codebase-memory-mcp -y` |
  38. | `agent-device-lab` | Prepare physical Android and iPhone tests, with separate iPhone Mirroring setup. | `npx skills add vincentkoc/dotskills --skill agent-device-lab -y` |
  39. | `codex-goal-mining` | Mine local or fleet Codex goal history into evidence-backed rerun suites. | `npx skills add vincentkoc/dotskills --skill codex-goal-mining -y` |
  40. | `codex-session-recovery` | Recover Codex and Claude tmux sessions without overwriting restore evidence. | `npx skills add vincentkoc/dotskills --skill codex-session-recovery -y` |
  41. | `crabpot-perf-metrics` | Interpret Crabpot and OpenClaw performance artifacts without over-reading noise. | `npx skills add vincentkoc/dotskills --skill crabpot-perf-metrics -y` |
  42. | `crawlkit` | Maintain and release the shared crawl app Go library. | `npx skills add vincentkoc/dotskills --skill crawlkit -y` |
  43. | `graincrawl` | Maintain and release the local-first Granola archive CLI. | `npx skills add vincentkoc/dotskills --skill graincrawl -y` |
  44. | `github-airplane-mode` | Switch an already-installed compatible local Git/GitHub download guard. | `npx skills add vincentkoc/dotskills --skill github-airplane-mode -y` |
  45. | `ghcrawl-cluster-operator` | Operate ghcrawl local sync, clustering, and cluster inspection from the CLI. | `npx skills add vincentkoc/dotskills --skill ghcrawl-cluster-operator -y` |
  46. | `openclaw-bun-upgrade` | Qualify and promote pinned Bun fork builds through the existing service owner. | `npx skills add vincentkoc/dotskills --skill openclaw-bun-upgrade -y` |
  47. | `openclaw-github-dedupe` | Triage GitHub issue/PR clusters across repositories, preserving contributor credit while selecting canonical fixes and safe closures. | `npx skills add vincentkoc/dotskills --skill openclaw-github-dedupe -y` |
  48. | `openclaw-pr-batch-sweep` | Select and land bounded batches of low-risk OpenClaw contributor pull requests. | `npx skills add vincentkoc/dotskills --skill openclaw-pr-batch-sweep -y` |
  49. | `org-branch-cleanup` | Audit and safely prune stale merged branches across a GitHub organization. | `npx skills add vincentkoc/dotskills --skill org-branch-cleanup -y` |
  50. | `operations-worktree` | Create safe git worktrees from fresh remote defaults instead of stale local branches. | `npx skills add vincentkoc/dotskills --skill operations-worktree -y` |
  51. | `semantic-slicing` | Build local feature, threat, issue, and support maps for focused repo review. | `npx skills add vincentkoc/dotskills --skill semantic-slicing -y` |
  52. | `technical-deslop` | Ship clean diffs fast: remove AI noise and keep behavior unchanged. | `npx skills add vincentkoc/dotskills --skill technical-deslop -y` |
  53. | `technical-documentation` | Build, review, and audit docs with Simplified Technical English, sharded large-tree audits, and Workflow/sub-agent fan-out. | `npx skills add vincentkoc/dotskills --skill technical-documentation -y` |
  54. | `session-done` | Prepare a session handoff; retain a Markdown note only when requested. | `npx skills add vincentkoc/dotskills --skill session-done -y` |
  55. | `technical-integrations` | Design integrations that land: vendor‑agnostic API/RFC/SDK plans with rollout safety. | `npx skills add vincentkoc/dotskills --skill technical-integrations -y` |
  56. | `technical-skill-finder` | Turn real agent pain into new skills: mine logs, rank wins, draft next steps. | `npx skills add vincentkoc/dotskills --skill technical-skill-finder -y` |
  57. | `tmux-agent-lane-orchestrator` | Monitor tmux coding-agent lanes and produce evidence-backed manager summaries. | `npx skills add vincentkoc/dotskills --skill tmux-agent-lane-orchestrator -y` |
  58. | `tmux-lane-orchestrator` | Coordinate one tmux worker lane from its matching manager pane. | `npx skills add vincentkoc/dotskills --skill tmux-lane-orchestrator -y` |
  59. Local-only skills may live under ignored `private-skills/`, but must never be tracked in this public repository.
  60. ## Install
  61. Install one skill:
  62. ```bash
  63. npx skills add vincentkoc/dotskills --skill ghcrawl-cluster-operator -y
  64. npx skills add vincentkoc/dotskills --skill agent-device-lab -y
  65. npx skills add vincentkoc/dotskills --skill codebase-memory-mcp -y
  66. npx skills add vincentkoc/dotskills --skill codex-goal-mining -y
  67. npx skills add vincentkoc/dotskills --skill codex-session-recovery -y
  68. npx skills add vincentkoc/dotskills --skill crabpot-perf-metrics -y
  69. npx skills add vincentkoc/dotskills --skill technical-deslop -y
  70. npx skills add vincentkoc/dotskills --skill technical-documentation -y
  71. npx skills add vincentkoc/dotskills --skill session-done -y
  72. npx skills add vincentkoc/dotskills --skill technical-integrations -y
  73. npx skills add vincentkoc/dotskills --skill technical-skill-finder -y
  74. npx skills add vincentkoc/dotskills --skill openclaw-github-dedupe -y
  75. npx skills add vincentkoc/dotskills --skill openclaw-pr-batch-sweep -y
  76. npx skills add vincentkoc/dotskills --skill org-branch-cleanup -y
  77. npx skills add vincentkoc/dotskills --skill openclaw-bun-upgrade -y
  78. npx skills add vincentkoc/dotskills --skill operations-worktree -y
  79. npx skills add vincentkoc/dotskills --skill crawlkit -y
  80. npx skills add vincentkoc/dotskills --skill graincrawl -y
  81. npx skills add vincentkoc/dotskills --skill github-airplane-mode -y
  82. npx skills add vincentkoc/dotskills --skill semantic-slicing -y
  83. npx skills add vincentkoc/dotskills --skill tmux-agent-lane-orchestrator -y
  84. npx skills add vincentkoc/dotskills --skill tmux-lane-orchestrator -y
  85. ```
  86. List available public skills:
  87. ```bash
  88. npx skills add vincentkoc/dotskills --list
  89. ```
  90. `github-airplane-mode` requires an already-installed compatible `low-data`
  91. command. Installing the skill does not install a network guard or change its mode.
  92. Default sync targets are managed automatically by vercel skills.
  93. ## Codex slash commands
  94. This repo can also mirror Codex slash-command prompts from `vendor/` and sync them to `~/.codex/prompts`.
  95. - `make sync` now syncs skills and slash commands for the `codex` profile.
  96. - vendored command currently included: `/sectriage` from `steipete/agent-scripts`.
  97. Local `make sync` and `make sync-copy` require macOS or Linux. Sync updates only
  98. same-source symlinks or unchanged managed copies. An older unmarked copy can be
  99. adopted when all content and modes match the current source. Different copies,
  100. extra local files, and foreign links require reconciliation before sync. Failed
  101. publication never overwrites an intervening destination; the error names any
  102. retained recovery directory that needs review before retrying.
  103. ### Move one managed skill to a new source
  104. Ordinary sync never infers a source change from a skill name. After verifying
  105. both sources' ownership and revisions, transition one unchanged managed copy:
  106. ```bash
  107. python3 scripts/managed_sync.py install-directory \
  108. --source /absolute/new-source/skill \
  109. --previous-source /absolute/old-source/skill \
  110. --destination /absolute/installed/skill --mode copy
  111. ```
  112. The old source must still exist and match the installed marker's binding.
  113. The installed content and modes must still match its recorded digest. Unmarked
  114. copies, symlinks, missing destinations, local edits, extra files, and wrong old
  115. bindings are refused. This operation copies the complete new skill, including
  116. relative resources, and publishes its new source binding using the same staging,
  117. no-replace, and recovery checks as ordinary sync. It does not alter either source
  118. or sibling skills. No bulk-sync option, marker reset, or trust decision is implied.
  119. On success, the command reports the retained `.agent-skills-stage-*` directory
  120. on stderr. Its `previous/` directory holds the old installed copy and marker.
  121. An open file descriptor can still write to that old copy after final validation;
  122. another digest check cannot make deletion safe. Only explicit source transitions
  123. retain successful recovery this way; ordinary sync cleanup is unchanged. Inspect
  124. and reconcile the retained copy through the existing recovery owner, after old
  125. writers have finished. Success does not authorize deleting that recovery.
  126. Record the old and new source revisions in the existing task/change record before
  127. running it. Keep immutable release sources intact; do not edit or repin a whole
  128. release to update one skill. After success, use the new source for ordinary sync;
  129. replaying the old binding is refused. A failed publication may also retain recovery
  130. as described above: inspect that recovery before any retry, never remove markers
  131. to force adoption. Source trust or release-ownership changes still require their
  132. own authorization; this explicit operation is not a bypass.
  133. ## Repository layout
  134. ```text
  135. skills/ # First-party skills
  136. <skill-name>/
  137. SKILL.md|AGENT.md|AGENTS.md
  138. references/
  139. scripts/
  140. private-skills/ # Private/local-only skills (not published)
  141. <skill-name>/
  142. SKILL.md|AGENT.md|AGENTS.md
  143. references/
  144. scripts/
  145. vendor/ # Third-party mirrored/imported skills
  146. .assets/ # Shared visual assets (banner/icon)
  147. bin/agent-skills # List/validate/sync/import
  148. scripts/ # Validation + publishing automation
  149. catalog.yaml # Skill metadata catalog
  150. .claude-plugin/marketplace.json
  151. releases/skills.json
  152. ```
  153. ## Validation
  154. `make validate` now runs:
  155. 1. repo policy checks (`Purpose/When to use/Workflow/Inputs/Outputs`, entry-file checks)
  156. 2. AgentSkills spec checks for local `SKILL.md` skills (`name`/`description` constraints, frontmatter validity, relative resource references, one-level reference depth)
  157. 3. public skill OpenAI metadata checks (`agents/openai.yaml`, required interface fields, default icons/brand from `AGENTS.md`, and icon path existence)
  158. If installed, the external reference validator is also used:
  159. ```bash
  160. skills-ref validate ./skills/<skill-name>
  161. ```
  162. ## Why .skills
  163. Dotfiles configure machines.
  164. `.skills` configures AI execution quality.
  165. This repo is meant to be composable, auditable, and practical: skills should be testable artifacts, not throwaway prompt snippets.
  166. ## Contributing
  167. Read [CONTRIBUTING.md](CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.