{
  "markdown": "# Common Skills\n\nThis repository is where common agent skills that should be shared across repositories go.\n\nA skill belongs here when it captures a reusable workflow, convention, or operating procedure that is useful in more than one repository. Repository-specific skills should stay with the repository they apply to unless they can be generalized without losing important context.\n\n## Repository layout\n\n```text\n.agents/\n  skills/\n    <skill-name>/\n      SKILL.md\n      scripts/      # optional helper scripts\n      references/   # optional supporting docs\n      assets/       # optional bundled assets\n```\n\nEach skill lives in its own directory under `.agents/skills/`. The only required file for a skill is `SKILL.md` with YAML frontmatter containing at least:\n\n- `name`: the kebab-case skill identifier\n- `description`: what the skill does and when agents should use it\n\n## Current skills\n\n### Spec workflow\n\n- `write-product-spec` — writes user-facing `PRODUCT.md` specs.\n- `write-tech-spec` — writes implementation-oriented `TECH.md` specs.\n- `spec-driven-implementation` — guides the full spec-first workflow for substantial features.\n- `implement-specs` — implements approved `PRODUCT.md` and `TECH.md` files while keeping specs and code aligned.\n\n### Development workflow\n\n- `create-pr` — guidance for preparing and opening pull requests.\n- `write-pr-description` — writes the PR body: template sections, plain-language prose, and reviewer guidance.\n- `diagnose-ci-failures` — workflow for inspecting GitHub CI failures and producing a fix plan.\n- `fix-errors` — guidance for fixing build, lint, formatting, and test failures.\n- `resolve-merge-conflicts` — workflow and helper script for resolving git conflicts with compact context.\n- `review-pr` — produces structured PR review feedback from local diff artifacts.\n- `check-impl-against-spec` — compares PR implementation changes against provided spec context during review.\n\n### Investigation and decision-making\n\n- `research` — delegates low signal-to-noise-ratio research work to subagents and returns distilled, evidence-backed findings.\n- `cross-critique` — sharpens contested decisions by having agents critique one another's independent proposals before synthesis.\n\n### Skill authoring\n\n- `update-skill` — guidance for creating and maintaining skill directories and `SKILL.md` files.\n- `skill-doctor` — grades a repo's installed skills by scoring recent local agent conversations, then drafts the skill edits the evidence justifies.\n\n## Adding a shared skill\n\nWhen adding a skill to this repository:\n\n1. Put it under `.agents/skills/<skill-name>/`.\n2. Include a `SKILL.md` with clear frontmatter.\n3. Keep the skill focused on a reusable workflow rather than one repository's private details.\n4. Move large reference material into `references/` and helper automation into `scripts/`.\n5. If copying from another repo, copy first, then generalize in a separate change so the provenance is easy to review.\n\n## Generalizing repository-specific skills\n\nSome skills copied here may still contain repository-specific examples, paths, commands, or assumptions. That is okay during initial migration, but shared skills should eventually be generalized by:\n\n- replacing hard-coded repository names with placeholders or conditional guidance\n- separating common workflow guidance from local repository conventions\n- moving repo-specific overrides back into the repository that needs them\n- keeping descriptions broad enough to trigger in multiple repositories, but specific enough to avoid unrelated tasks\n\n## Usage\n\nConsumers can install the shared skills with the `skills` CLI.\n\nList available skills:\n\n```sh\nnpx skills@latest add warpdotdev/common-skills --list\n```\n\nInstall all common skills for Warp globally:\n\n```sh\nnpx skills@latest add warpdotdev/common-skills --skill '*' --agent warp --global\n```\n\nInstall one skill:\n\n```sh\nnpx skills@latest add warpdotdev/common-skills --skill write-tech-spec --agent warp --global\n```\n\nUpdate installed skills later:\n\n```sh\nnpx skills@latest update --global --agent warp\n```\n\nYou can also copy or sync selected directories from `.agents/skills/` into a repository's own `.agents/skills/` directory.\n\nPrefer copying only the skills a repository actually needs. If a common skill needs repository-specific behavior, add a small local companion skill in that repository rather than forking the shared skill unless the change is useful everywhere.\n",
  "bytes": 4447,
  "sha": "606bd8b0e376a7291f3fb205704e2d1f005e14cd333ee44d0e260498b3df20bb",
  "repo_slug": "warpdotdev/common-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_warpdotdev_common_skills_validate_change_f9825b65/readme"
}