{
"markdown": "\n\n \n\n# .skills (dotskills)\n\n[](https://github.com/vincentkoc/dotskills/actions/workflows/validate.yml)\n[](https://github.com/vincentkoc/dotskills/actions/workflows/release.yml)\n[](https://github.com/vincentkoc/dotskills/actions/workflows/verify-install.yml)\n[](https://github.com/vincentkoc/dotskills/actions/workflows/codeql.yml)\n[](LICENSE)\n[](https://github.com/vincentkoc/dotskills/tags)\n[](CONTRIBUTING.md)\n\n
\n\nWe 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.\n\n## How this repo works\n\nThis 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:\n\n- prompt logic (`SKILL.md` / `AGENT.md` / `AGENTS.md`)\n- references and knowledge assets\n- scripts for deterministic execution\n- repeatable validation + publishing workflows\n- support external skills through submodules\n- git managed personal registry and github action hooks\n\n## Configuration ownership\n\nKeep each configuration with the component that installs and validates it:\n\n| Configuration | Owner |\n|---|---|\n| Reusable skills, references, and bundled helpers | This repository |\n| Personal global agent instructions | [dotfiles `.codex/AGENTS.md`](https://github.com/vincentkoc/dotfiles/blob/master/.codex/AGENTS.md) |\n| Repository-specific `AGENTS.md` instructions | The repository they govern |\n| MCP registrations, machine-local settings, and credential injection | The platform's dotfiles/bootstrap installer |\n\n`make sync` selects agent targets such as `codex` and `cursor`. It installs\nskills and the supported slash-command prompts; it does not render repository\ninstructions or MCP configuration. Use the platform installer to reconcile a\nmachine's MCP setup, and keep credentials out of skill packages. This avoids a\nsecond configuration generator competing with those owners.\n\n## Public skills\n\n| Skill | What it does | Install |\n|---|---|---|\n| `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` |\n| `agent-device-lab` | Prepare physical Android and iPhone tests, with separate iPhone Mirroring setup. | `npx skills add vincentkoc/dotskills --skill agent-device-lab -y` |\n| `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` |\n| `codex-session-recovery` | Recover Codex and Claude tmux sessions without overwriting restore evidence. | `npx skills add vincentkoc/dotskills --skill codex-session-recovery -y` |\n| `crabpot-perf-metrics` | Interpret Crabpot and OpenClaw performance artifacts without over-reading noise. | `npx skills add vincentkoc/dotskills --skill crabpot-perf-metrics -y` |\n| `crawlkit` | Maintain and release the shared crawl app Go library. | `npx skills add vincentkoc/dotskills --skill crawlkit -y` |\n| `graincrawl` | Maintain and release the local-first Granola archive CLI. | `npx skills add vincentkoc/dotskills --skill graincrawl -y` |\n| `github-airplane-mode` | Switch an already-installed compatible local Git/GitHub download guard. | `npx skills add vincentkoc/dotskills --skill github-airplane-mode -y` |\n| `ghcrawl-cluster-operator` | Operate ghcrawl local sync, clustering, and cluster inspection from the CLI. | `npx skills add vincentkoc/dotskills --skill ghcrawl-cluster-operator -y` |\n| `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` |\n| `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` |\n| `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` |\n| `org-branch-cleanup` | Audit and safely prune stale merged branches across a GitHub organization. | `npx skills add vincentkoc/dotskills --skill org-branch-cleanup -y` |\n| `opik-integrations-auditor` | Audit Opik integration coverage across SDK and OTEL/API surfaces. | `npx skills add vincentkoc/dotskills --skill opik-integrations-auditor -y` |\n| `opik-optimizer` | Optimize prompts, tools, agents, and parameters through Opik workflows. | `npx skills add vincentkoc/dotskills --skill opik-optimizer -y` |\n| `operations-worktree` | Create safe git worktrees from fresh remote defaults instead of stale local branches. | `npx skills add vincentkoc/dotskills --skill operations-worktree -y` |\n| `semantic-slicing` | Build local feature, threat, issue, and support maps for focused repo review. | `npx skills add vincentkoc/dotskills --skill semantic-slicing -y` |\n| `technical-deslop` | Ship clean diffs fast: remove AI noise and keep behavior unchanged. | `npx skills add vincentkoc/dotskills --skill technical-deslop -y` |\n| `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` |\n| `session-done` | Prepare a session handoff; retain a Markdown note only when requested. | `npx skills add vincentkoc/dotskills --skill session-done -y` |\n| `technical-integrations` | Design integrations that land: vendor‑agnostic API/RFC/SDK plans with rollout safety. | `npx skills add vincentkoc/dotskills --skill technical-integrations -y` |\n| `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` |\n| `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` |\n| `tmux-lane-orchestrator` | Coordinate one tmux worker lane from its matching manager pane. | `npx skills add vincentkoc/dotskills --skill tmux-lane-orchestrator -y` |\n\nLocal-only skills may live under ignored `private-skills/`, but must never be tracked in this public repository.\n\n## Install\n\nInstall one skill:\n\n```bash\nnpx skills add vincentkoc/dotskills --skill ghcrawl-cluster-operator -y\nnpx skills add vincentkoc/dotskills --skill agent-device-lab -y\nnpx skills add vincentkoc/dotskills --skill codebase-memory-mcp -y\nnpx skills add vincentkoc/dotskills --skill codex-goal-mining -y\nnpx skills add vincentkoc/dotskills --skill codex-session-recovery -y\nnpx skills add vincentkoc/dotskills --skill crabpot-perf-metrics -y\nnpx skills add vincentkoc/dotskills --skill technical-deslop -y\nnpx skills add vincentkoc/dotskills --skill technical-documentation -y\nnpx skills add vincentkoc/dotskills --skill session-done -y\nnpx skills add vincentkoc/dotskills --skill technical-integrations -y\nnpx skills add vincentkoc/dotskills --skill technical-skill-finder -y\nnpx skills add vincentkoc/dotskills --skill openclaw-github-dedupe -y\nnpx skills add vincentkoc/dotskills --skill openclaw-pr-batch-sweep -y\nnpx skills add vincentkoc/dotskills --skill org-branch-cleanup -y\nnpx skills add vincentkoc/dotskills --skill opik-integrations-auditor -y\nnpx skills add vincentkoc/dotskills --skill opik-optimizer -y\nnpx skills add vincentkoc/dotskills --skill openclaw-bun-upgrade -y\nnpx skills add vincentkoc/dotskills --skill operations-worktree -y\nnpx skills add vincentkoc/dotskills --skill crawlkit -y\nnpx skills add vincentkoc/dotskills --skill graincrawl -y\nnpx skills add vincentkoc/dotskills --skill github-airplane-mode -y\nnpx skills add vincentkoc/dotskills --skill semantic-slicing -y\nnpx skills add vincentkoc/dotskills --skill tmux-agent-lane-orchestrator -y\nnpx skills add vincentkoc/dotskills --skill tmux-lane-orchestrator -y\n```\n\nList available public skills:\n\n```bash\nnpx skills add vincentkoc/dotskills --list\n```\n\n`github-airplane-mode` requires an already-installed compatible `low-data`\ncommand. Installing the skill does not install a network guard or change its mode.\n\nDefault sync targets are managed automatically by vercel skills.\n\n## Codex slash commands\n\nThis repo can also mirror Codex slash-command prompts from `vendor/` and sync them to `~/.codex/prompts`.\n\n- `make sync` now syncs skills and slash commands for the `codex` profile.\n- vendored command currently included: `/sectriage` from `steipete/agent-scripts`.\n\nLocal `make sync` and `make sync-copy` require macOS or Linux. Sync updates only\nsame-source symlinks or unchanged managed copies. An older unmarked copy can be\nadopted when all content and modes match the current source. Different copies,\nextra local files, and foreign links require reconciliation before sync. Failed\npublication never overwrites an intervening destination; the error names any\nretained recovery directory that needs review before retrying.\n\n## Repository layout\n\n```text\nskills/ # First-party skills\n /\n SKILL.md|AGENT.md|AGENTS.md\n references/\n scripts/\nprivate-skills/ # Private/local-only skills (not published)\n /\n SKILL.md|AGENT.md|AGENTS.md\n references/\n scripts/\nvendor/ # Third-party mirrored/imported skills\n.assets/ # Shared visual assets (banner/icon)\nbin/agent-skills # List/validate/sync/import\nscripts/ # Validation + publishing automation\ncatalog.yaml # Skill metadata catalog\n.claude-plugin/marketplace.json\nreleases/skills.json\n```\n\n## Validation\n\n`make validate` now runs:\n\n1. repo policy checks (`Purpose/When to use/Workflow/Inputs/Outputs`, entry-file checks)\n2. AgentSkills spec checks for local `SKILL.md` skills (`name`/`description` constraints, frontmatter validity, relative resource references, one-level reference depth)\n3. public skill OpenAI metadata checks (`agents/openai.yaml`, required interface fields, default icons/brand from `AGENTS.md`, and icon path existence)\n\nIf installed, the external reference validator is also used:\n\n```bash\nskills-ref validate ./skills/\n```\n\n## Why .skills\n\nDotfiles configure machines.\n`.skills` configures AI execution quality.\n\nThis repo is meant to be composable, auditable, and practical: skills should be testable artifacts, not throwaway prompt snippets.\n\n## Contributing\n\nRead [CONTRIBUTING.md](CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).\n",
"bytes": 11697,
"sha": "ce1ad152cfc60e5dd4b8f193ae66641358879c3c73cfcf0eeb3f85c33fc26c09",
"repo_slug": "vincentkoc/dotskills",
"fonte": "repo",
"truncated": false,
"api": "https://api.agentalog.com/api/listings/skl_vincentkoc_dotskills_opik_optimizer_2c065e98/readme"
}