Superset Project Setup
superset-sh/superset
Makes a repository Superset-ready by writing .superset/config.json with setup, teardown and run scripts, then proving it with a real throwaway workspace.
Developer-experience friction auditing and fixing — slow onboarding, repeated manual setup steps, missing bootstrap/reset/seed scripts, undiscoverable conventions.
$ npx skills add pproenca/dot-skills --skill dx-harness -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install pproenca/dot-skills dx-harness --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.experimental/dx-harness .claude/skills/dx-harness && rm -rf skills-srcUse ~/.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/
Install the "dx-harness" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/dx-harness into .claude/skills/dx-harness/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dx-harness", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/dx-harnessType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add pproenca/dot-skills --skill dx-harness -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install pproenca/dot-skills dx-harness --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/.experimental/dx-harness .agents/skills/dx-harness && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "dx-harness" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/dx-harness into .agents/skills/dx-harness/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dx-harness", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pproenca/dot-skills --skill dx-harness -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install pproenca/dot-skills dx-harness --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/.experimental/dx-harness .cursor/skills/dx-harness && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "dx-harness" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/dx-harness into .cursor/skills/dx-harness/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dx-harness", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/pproenca/dot-skills.git --path skills/.experimental/dx-harness--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add pproenca/dot-skills --skill dx-harness -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install pproenca/dot-skills dx-harness --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/.experimental/dx-harness .gemini/skills/dx-harness && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "dx-harness" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/dx-harness into .gemini/skills/dx-harness/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dx-harness", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install pproenca/dot-skills dx-harnessInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add pproenca/dot-skills --skill dx-harness -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/.experimental/dx-harness .github/skills/dx-harness && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "dx-harness" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/dx-harness into .github/skills/dx-harness/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dx-harness", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pproenca/dot-skills --skill dx-harness -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install pproenca/dot-skills dx-harness --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/.experimental/dx-harness .opencode/skills/dx-harness && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "dx-harness" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/dx-harness into .opencode/skills/dx-harness/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dx-harness", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
dx-harnessDeveloper-experience friction auditing and fixing — slow onboarding, repeated manual setup steps, missing bootstrap/reset/seed scripts, undiscoverable conventions.
Dx Harness is an agent skill from pproenca/dot-skills. Developer-experience friction auditing and fixing — slow onboarding, repeated manual setup steps, missing bootstrap/reset/seed scripts, undiscoverable conventions. Audits the repo, scores findings, scaffolds canonical fixes (bootstrap.sh, reset.sh, seed.sh, AGENTS.md, task-runner entries), then verifies the harness end-to-end in a scratch worktree against a 60-second time-to-first-commit target. Triggers on phrases like "audit dx", "fix dev friction", "time to first commit", "set up the harness", "I keep doing X…
Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 31 other files, including scripts, reference files and assets (for example `config.json`, `gotchas.md` and `metadata.json`).
It sits in Development, covering Project scaffolding, Git worktrees and End-to-end testing. It works with Docker. The repository describes itself as: A collection of AI agent skills following the Agent Skills open format. The licence is MIT.
Read from SKILL.md and the folder at commit cf93c57. It shows what the files ask for, not the result of running them.
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.
Ships 3 files in scripts/ (Shell, from the files we listed), which the agent can run.
Shell commands in SKILL.md call:
bashFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Dx Harness loads about 1.5k tokens when it runs, and up to ~8.1k if it reads all its reference files. Until then it costs about 182 tokens; SKILL.md has 482 words of instructions outside code blocks.
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.
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.
The full file from pproenca/dot-skills at commit cf93c57, republished under its MIT licence (© pproenca). 482 words, ~1,516 tokens.
.claude/skills/dx-harness/SKILL.md (or your agent's skills folder). This skill also uses 27 other files; get the full folder from GitHub.Audits, scaffolds, and maintains the developer-experience harness of a repository. The harness is the meta-tooling that makes a dev loop fast: one-command bootstrap, one-command reset, one-command seed, discoverable conventions, agent-friendly entry points.
This skill exists because dev-experience attrition is real: harnesses rot, manual steps creep back in, conventions drift, and the cost is paid in micro-friction every day. The skill detects attrition systematically and applies canonical fixes.
Trigger this skill when:
┌────────────────────────────────────────────────────────────┐
│ 1. DISCOVER scripts/discover.sh → repo-fingerprint │
│ 2. AUDIT scripts/audit.sh → dx-audit.json │
│ 3. PRIORITIZE scripts/prioritize.sh → ranked findings │
│ 4. SCAFFOLD scripts/scaffold-*.sh → scratch dir │
│ 5. CONFIRM show diff to user; user picks what to apply│
│ 6. VERIFY scripts/verify.sh → assertions + timing │
│ 7. TRACK scripts/track-attrition.sh → audit log │
└────────────────────────────────────────────────────────────┘All scaffolded edits land in a scratch directory first (${TMPDIR}/dx-harness-<timestamp>/). The user reviews the diff and chooses what to copy back into the repo. No surprise writes to the working tree.
Required: bash, git, node, jq.
Detected at runtime (the skill adapts — it never forces a migration):
| Toolchain | Detection signal |
|---|---|
| npm/pnpm/yarn/bun | package.json, pnpm-lock.yaml, yarn.lock, bun.lockb |
| cargo | Cargo.toml |
| go modules | go.mod |
| Python (uv/poetry/pip) | pyproject.toml, uv.lock, poetry.lock, requirements.txt |
| just | Justfile or justfile |
| make | Makefile |
| docker compose | docker-compose.yml, compose.yaml |
| database (postgres) | docker-compose.yml services, DATABASE_URL env reference |
Write. The skill writes files but does not delete user data, force-push, or run destructive ops. Default mode stages everything in a scratch directory; the user explicitly approves each application. Verification runs in a separate git worktree so timing measurements never touch the working tree.
On first invocation, the skill checks config.json and prompts via AskUserQuestion for any empty required fields. See config.json for fields and defaults.
Key defaults:
ttfc_target_seconds: 60 — the time-to-first-commit goal in secondsapply_mode: "scratch" — scaffolded edits go to scratch dir first; user copies inaudit_log_path: "${CLAUDE_PLUGIN_DATA}/dx-harness/audits.log" — persistent attrition historybash scripts/discover.sh > /tmp/fingerprint.json
bash scripts/audit.sh /tmp/fingerprint.json > /tmp/audit.json
bash scripts/prioritize.sh /tmp/audit.jsonbash scripts/scaffold-bootstrap.sh /tmp/fingerprint.json
bash scripts/scaffold-reset.sh /tmp/fingerprint.json
bash scripts/scaffold-seed.sh /tmp/fingerprint.json
bash scripts/scaffold-agents-md.sh /tmp/fingerprint.json
bash scripts/scaffold-justfile.sh /tmp/fingerprint.jsonbash scripts/verify.sh
# runs bootstrap in a scratch worktree, times it, asserts TTFC < targetbash scripts/track-attrition.sh /tmp/audit.json
# appends to audits.log, prints diff vs previous runThe workflow scripts produce JSON between steps so they compose. The agent should read references/workflow.md for full step-by-step orchestration, including error handling and when to stop and ask the user.
For deeper context:
| File | Read When |
|---|---|
| references/workflow.md | Executing the workflow (always start here) |
| references/audit-checklist.md | Understanding what audit.sh checks and why |
| references/fix-recipes.md | Choosing which scaffold script applies for a finding |
| references/attrition-patterns.md | Reading git history for DX-rot signals |
See gotchas.md — accumulated failure points discovered over time. Always append new ones rather than rewriting.
dev-skill:* — for creating new agent-friendly skills (often the output of an AGENTS.md scaffolding pass references skills)bug-review — pairs naturally: bad DX often surfaces as repeat bug categories© pproenca, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 27 other files (scripts, references, assets) in skills/.experimental/dx-harness of pproenca/dot-skills.
Open the folder on GitHubat commit cf93c57
Dx Harness 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Dx Harness this skillpproenca/dot-skills | 215 | — | ~1.5k | Automated safety check: Pass | MIT | |
| Superset Project Setupsuperset-sh/superset | 15k | — | ~577 | Automated safety check: Notes | Custom licence | |
| Start Tempsgotempsh/temps | 826 | — | ~5.4k | Automated safety check: Pass | Apache-2.0 | |
| Build Px4 macOSPX4/PX4-Autopilot | 13k | — | ~1.1k | Automated safety check: Pass | BSD-3-Clause | |
| Development WorkflownelsonPires5/herdr-board | 170 | — | ~2.4k | Automated safety check: Pass | None | |
| Tnr Dev Serverstudie-tech/TheNinjaRPG | 104 | — | ~2.5k | Automated safety check: Notes | None |
superset-sh/superset
Makes a repository Superset-ready by writing .superset/config.json with setup, teardown and run scripts, then proving it with a real throwaway workspace.
gotempsh/temps
Start (or restart) a local Temps control plane built from this checkout, and the web dev server (bun dev) in <checkout/web.
PX4/PX4-Autopilot
Build PX4 board firmware on macOS in the px4-dev Docker container, including git worktrees, and stage commit-labeled artifacts without flashing hardware.
nelsonPires5/herdr-board
Default sandbox-first developer workflow for herdr-board. An agent skill from nelsonPires5/herdr-board.
studie-tech/TheNinjaRPG
Run a TheNinjaRPG dev server locally from any git worktree, provision disposable test users, and call tRPC endpoints as those users.
sickn33/agentic-awesome-skills
Generate project-specific AGENTS.md and companion rules by analyzing a codebase.
pproenca/dot-skills
Audio forensics and voice recovery guidelines for CSI-level audio analysis.
pproenca/dot-skills
Guided, scripted pipeline for running JSX/TSX/React codemods safely across large legacy codebases.
pproenca/dot-skills
Create well-structured RFCs and technical proposals for software projects.
pproenca/dot-skills
Turn a rough idea for a language into a complete, implementable specification — a DSL, query, config/data, template, or protocol language — by interviewing the author dimension by dimension until…
pproenca/dot-skills
Drafting Python Enhancement Proposals (PEPs) — proposing a Python language feature, a standard library change, an interoperability standard, or an informational/process document for the Python…
pproenca/dot-skills
Designs new features, extensions, or modifications to Uncle Bob's Acceptance Pipeline Specification — new mutation strategies, Gherkin syntax support, report formats, pipeline stages, IR fields, or…
Works with
Categories
Developer-experience friction auditing and fixing — slow onboarding, repeated manual setup steps, missing bootstrap/reset/seed scripts, undiscoverable conventions. Dx Harness is an agent skill from pproenca/dot-skills. Developer-experience friction auditing and fixing — slow onboarding, repeated manual setup steps, missing bootstrap/reset/seed scripts, undiscoverable conventions.
Dx Harness fits situations like: phrases like audit dx; fix dev friction; time to first commit; set up the harness.
Run `npx skills add pproenca/dot-skills --skill dx-harness -a claude-code`. Or copy the skill folder (skills/.experimental/dx-harness in pproenca/dot-skills) into .claude/skills/dx-harness in your project. Claude Code loads it when a task matches its description.
Run `npx skills add pproenca/dot-skills --skill dx-harness -a codex`. Or copy the skill folder (skills/.experimental/dx-harness in pproenca/dot-skills) into .agents/skills/dx-harness in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pproenca/dot-skills --skill dx-harness -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dx-harness, .gemini/skills/dx-harness, .github/skills/dx-harness and .opencode/skills/dx-harness in your project.
Going by SKILL.md and its folder, Dx Harness needs a shell for the scripts in its folder and the command-line tools its instructions call (bash). Our summary lists: Python 3; A Bash shell; Docker.
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.
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.
Dx Harness is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.5k tokens (SKILL.md is roughly 6.1k 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 6.5k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Dx Harness: Superset Project Setup (superset-sh/superset, 15k stars), Start Temps (gotempsh/temps, 826 stars), Build Px4 macOS (PX4/PX4-Autopilot, 13k stars) and Development Workflow (nelsonPires5/herdr-board, 170 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
pproenca (a GitHub user) maintains it in pproenca/dot-skills, which has 215 GitHub stars. The repository holds 41 skills in this directory. The repository was last updated on August 15, 2026.
Source: pproenca/dot-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.