Skip to content
Back to search

common-skills

This repository is where common agent skills that should be shared across repositories go.

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

Its scripts were only partly scanned.

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/warpdotdev/common-skills 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/warpdotdev/common-skills'

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/warpdotdev--common-skills/badge.svg)](/listings/warpdotdev--common-skills)

HTML

<a href="/listings/warpdotdev--common-skills"><img src="/api/listings/warpdotdev--common-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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.

README.md · README · 107 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. # Common Skills
  2. This repository is where common agent skills that should be shared across repositories go.
  3. A 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.
  4. ## Repository layout
  5. ```text
  6. .agents/
  7. skills/
  8. <skill-name>/
  9. SKILL.md
  10. scripts/ # optional helper scripts
  11. references/ # optional supporting docs
  12. assets/ # optional bundled assets
  13. ```
  14. Each 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:
  15. - `name`: the kebab-case skill identifier
  16. - `description`: what the skill does and when agents should use it
  17. ## Current skills
  18. ### Spec workflow
  19. - `write-product-spec` — writes user-facing `PRODUCT.md` specs.
  20. - `write-tech-spec` — writes implementation-oriented `TECH.md` specs.
  21. - `spec-driven-implementation` — guides the full spec-first workflow for substantial features.
  22. - `implement-specs` — implements approved `PRODUCT.md` and `TECH.md` files while keeping specs and code aligned.
  23. ### Development workflow
  24. - `create-pr` — guidance for preparing and opening pull requests.
  25. - `write-pr-description` — writes the PR body: template sections, plain-language prose, and reviewer guidance.
  26. - `diagnose-ci-failures` — workflow for inspecting GitHub CI failures and producing a fix plan.
  27. - `fix-errors` — guidance for fixing build, lint, formatting, and test failures.
  28. - `resolve-merge-conflicts` — workflow and helper script for resolving git conflicts with compact context.
  29. - `review-pr` — produces structured PR review feedback from local diff artifacts.
  30. - `merge-risk` — asses the risk of merging a PR from low to high.
  31. - `check-impl-against-spec` — compares PR implementation changes against provided spec context during review.
  32. ### Factory workflow
  33. - `migrate-to-factory` — translates existing file-defined agent workflows, skills, and scripts into an existing Warp Factory configuration repository.
  34. ### Investigation and decision-making
  35. - `research` — delegates low signal-to-noise-ratio research work to subagents and returns distilled, evidence-backed findings.
  36. - `cross-critique` — sharpens contested decisions by having agents critique one another's independent proposals before synthesis.
  37. ### Skill authoring
  38. - `update-skill` — guidance for creating and maintaining skill directories and `SKILL.md` files.
  39. - `skill-doctor` — grades a repo's installed skills by scoring recent local agent conversations, then drafts the skill edits the evidence justifies.
  40. ## Adding a shared skill
  41. When adding a skill to this repository:
  42. 1. Put it under `.agents/skills/<skill-name>/`.
  43. 2. Include a `SKILL.md` with clear frontmatter.
  44. 3. Keep the skill focused on a reusable workflow rather than one repository's private details.
  45. 4. Move large reference material into `references/` and helper automation into `scripts/`.
  46. 5. If copying from another repo, copy first, then generalize in a separate change so the provenance is easy to review.
  47. ## Generalizing repository-specific skills
  48. Some 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:
  49. - replacing hard-coded repository names with placeholders or conditional guidance
  50. - separating common workflow guidance from local repository conventions
  51. - moving repo-specific overrides back into the repository that needs them
  52. - keeping descriptions broad enough to trigger in multiple repositories, but specific enough to avoid unrelated tasks
  53. ## Usage
  54. Consumers can install the shared skills with the `skills` CLI.
  55. List available skills:
  56. ```sh
  57. npx skills@latest add warpdotdev/common-skills --list
  58. ```
  59. Install all common skills for Warp globally:
  60. ```sh
  61. npx skills@latest add warpdotdev/common-skills --skill '*' --agent warp --global
  62. ```
  63. Install one skill:
  64. ```sh
  65. npx skills@latest add warpdotdev/common-skills --skill write-tech-spec --agent warp --global
  66. ```
  67. Update installed skills later:
  68. ```sh
  69. npx skills@latest update --global --agent warp
  70. ```
  71. You can also copy or sync selected directories from `.agents/skills/` into a repository's own `.agents/skills/` directory.
  72. Prefer 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.

Ratings and comments

Sign in to rate this skill.

Sign in

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