Skip to content
Back to search

builder-essential-skills

A repository for skills that are essential to my daily work

Safety scan

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

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tamdogood-builder-essential-skills/badge.svg)](/listings/tamdogood-builder-essential-skills)

HTML

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

Install

i

Install instructions from the README

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

Install with the skills.sh CLI:

npx skills add tamdogood/skills

Install one skill from the collection:

npx skills add tamdogood/skills --skill lead

The skills.sh page for this repository is [skills.sh/tamdogood/skills](https://skills.sh/tamdogood/skills). It appears after the repository has been installed through the `skills` CLI and the skills.sh cache refreshes.

You can also use the bundled npm installer.

Install every skill for your user account:

npx @tamng0905/builder-essential-skills

Install into the repository you are currently in:

npx @tamng0905/builder-essential-skills --project

Install only one skill:

npx @tamng0905/builder-essential-skills --skill lead

Add `--project` to that command to install the selected skill into the current repository. Restart Claude Code or Codex after installation.

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 · 324 lines

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

  1. <p align="center">
  2. <img src="assets/readme-hero.png" alt="Builder's Essential Skills, shown as an original dark atelier of connected creative tools" width="100%">
  3. </p>
  4. <p align="center">
  5. <strong>Builder's Essential Skills</strong><br>
  6. A considered collection of reusable workflows for planning, building, researching, learning, validating, writing, and reviewing with Claude Code and Codex.
  7. </p>
  8. <p align="center">
  9. <a href="https://www.npmjs.com/package/@tamng0905/builder-essential-skills"><img src="https://img.shields.io/npm/v/%40tamng0905%2Fbuilder-essential-skills?logo=npm&amp;label=npm" alt="npm package version"></a>
  10. </p>
  11. <p align="center">
  12. <a href="#install">Install</a> ·
  13. <a href="#pick-a-skill">Pick a skill</a> ·
  14. <a href="#bring-your-own-workflow">Create a skill</a>
  15. </p>
  16. ## Install
  17. Install with the skills.sh CLI:
  18. ```bash
  19. npx skills add tamdogood/skills
  20. ```
  21. Install one skill from the collection:
  22. ```bash
  23. npx skills add tamdogood/skills --skill lead
  24. ```
  25. The skills.sh page for this repository is
  26. [skills.sh/tamdogood/skills](https://skills.sh/tamdogood/skills). It appears
  27. after the repository has been installed through the `skills` CLI and the
  28. skills.sh cache refreshes.
  29. You can also use the bundled npm installer.
  30. Install every skill for your user account:
  31. ```bash
  32. npx @tamng0905/builder-essential-skills
  33. ```
  34. Install into the repository you are currently in:
  35. ```bash
  36. npx @tamng0905/builder-essential-skills --project
  37. ```
  38. Install only one skill:
  39. ```bash
  40. npx @tamng0905/builder-essential-skills --skill lead
  41. ```
  42. Add `--project` to that command to install the selected skill into the current
  43. repository. Restart Claude Code or Codex after installation.
  44. ## Pick a skill
  45. <table>
  46. <tr>
  47. <td width="50%" valign="top">
  48. <a href="skills/lead/SKILL.md"><img src="assets/skill-banners/lead.webp" alt="lead — build and delivery skill" width="100%"></a>
  49. </td>
  50. <td width="50%" valign="top">
  51. <a href="skills/lead-research/SKILL.md"><img src="assets/skill-banners/lead-research.webp" alt="lead-research — research and strategy skill" width="100%"></a>
  52. </td>
  53. </tr>
  54. <tr>
  55. <td width="50%" valign="top">
  56. <a href="skills/async-learning-teacher/SKILL.md"><img src="assets/skill-banners/async-learning-teacher.webp" alt="async-learning-teacher — learning skill" width="100%"></a>
  57. </td>
  58. <td width="50%" valign="top">
  59. <a href="skills/top-one-percent/SKILL.md"><img src="assets/skill-banners/top-one-percent.webp" alt="top-one-percent — deep explanation and mastery skill" width="100%"></a>
  60. </td>
  61. </tr>
  62. <tr>
  63. <td width="50%" valign="top">
  64. <a href="skills/validate-market/SKILL.md"><img src="assets/skill-banners/validate-market.webp" alt="validate-market — product and market skill" width="100%"></a>
  65. </td>
  66. <td width="50%" valign="top">
  67. <a href="skills/paper-opportunity-radar/SKILL.md"><img src="assets/skill-banners/paper-opportunity-radar.webp" alt="paper-opportunity-radar — research forensics and opportunity discovery skill" width="100%"></a>
  68. </td>
  69. </tr>
  70. <tr>
  71. <td width="50%" valign="top">
  72. <a href="skills/write-blog/SKILL.md"><img src="assets/skill-banners/write-blog.webp" alt="write-blog — writing and growth skill" width="100%"></a>
  73. </td>
  74. <td width="50%" valign="top">
  75. <a href="skills/orwell-writing/SKILL.md"><img src="assets/skill-banners/orwell-writing.webp" alt="orwell-writing — direct writing skill" width="100%"></a>
  76. </td>
  77. </tr>
  78. <tr>
  79. <td width="50%" valign="top">
  80. <a href="skills/code-standards/SKILL.md"><img src="assets/skill-banners/code-standards.webp" alt="code-standards — engineering quality skill" width="100%"></a>
  81. </td>
  82. <td width="50%" valign="top">
  83. <a href="skills/session-profiler/SKILL.md"><img src="assets/skill-banners/session-profiler.webp" alt="session-profiler — developer tools skill" width="100%"></a>
  84. </td>
  85. </tr>
  86. <tr>
  87. <td width="50%" valign="top">
  88. <a href="skills/make-playbook/SKILL.md"><img src="assets/skill-banners/make-playbook.webp" alt="make-playbook — indie maker playbook skill" width="100%"></a>
  89. </td>
  90. <td width="50%" valign="top">
  91. <a href="skills/create-skill/SKILL.md"><img src="assets/skill-banners/create-skill.webp" alt="create-skill — skill creation workflow" width="100%"></a>
  92. </td>
  93. </tr>
  94. <tr>
  95. <td width="50%" valign="top">
  96. <a href="skills/create-marketing-kit/SKILL.md"><img src="assets/skill-banners/create-marketing-kit.webp" alt="create-marketing-kit — campaign copy and artwork skill" width="100%"></a>
  97. </td>
  98. <td width="50%" valign="top">
  99. <a href="skills/map-the-landscape/SKILL.md"><img src="assets/skill-banners/map-the-landscape.webp" alt="map-the-landscape — big-picture orientation skill" width="100%"></a>
  100. </td>
  101. </tr>
  102. <tr>
  103. <td width="50%" valign="top">
  104. <a href="skills/build-scenario-tests/SKILL.md"><img src="assets/skill-banners/build-scenario-tests.webp" alt="build-scenario-tests — deterministic behavior validation skill" width="100%"></a>
  105. </td>
  106. <td width="50%" valign="top">
  107. <a href="skills/run-smoke-tests/SKILL.md"><img src="assets/skill-banners/run-smoke-tests.webp" alt="run-smoke-tests — auditable user journey validation skill" width="100%"></a>
  108. </td>
  109. </tr>
  110. <tr>
  111. <td width="50%" valign="top">
  112. <a href="skills/name-your-business/SKILL.md"><img src="assets/skill-banners/name-your-business.webp" alt="name-your-business — fast naming and selective live validation skill" width="100%"></a>
  113. </td>
  114. <td width="50%" valign="top">
  115. <a href="skills/repo-system-map/SKILL.md"><img src="assets/skill-banners/repo-system-map.webp" alt="repo-system-map — interactive repository architecture learning skill" width="100%"></a>
  116. </td>
  117. </tr>
  118. </table>
  119. Every skill lives in `skills/<name>/SKILL.md`. Some also ship scripts,
  120. reference material, or agent definitions that support the workflow.
  121. ## Why this exists
  122. An AI agent is much more useful when it has a repeatable way to handle the
  123. work. This collection packages practical workflows as portable skills: compact
  124. instructions, scripts, references, and agent definitions that you can install,
  125. adapt, and share.
  126. Use the whole collection, or take only the skills your team needs.
  127. ## Local install
  128. Use the local scripts only when you are installing from a cloned checkout.
  129. From the repository root, install every skill for the current user:
  130. ```bash
  131. ./install.sh
  132. ```
  133. The `npx` command installs the same files as the scripts below. It supports
  134. macOS, Linux, and Windows wherever Node.js 18 or newer is available.
  135. On Windows:
  136. ```powershell
  137. ./install.ps1
  138. ```
  139. Restart Claude Code or Codex, then invoke a skill in plain English:
  140. ```text
  141. /lead Build the smallest version of this feature and open a PR.
  142. $async-learning-teacher Teach me this paper step by step: https://arxiv.org/abs/...
  143. $map-the-landscape Show me how this repository fits together.
  144. $paper-opportunity-radar Audit this topic's buried research for credible opportunities.
  145. ```
  146. Want to try the collection inside one repository first? Install it locally
  147. instead:
  148. ```bash
  149. ./install.sh --project
  150. ```
  151. ```powershell
  152. ./install.ps1 -Project
  153. ```
  154. The project install uses `.claude/skills` and `.codex/skills`, so it stays
  155. with that repository rather than changing your user-level setup.
  156. ## What gets installed
  157. The installers copy each folder in `skills/` to the right location for your
  158. agent runtime.
  159. | Install mode | Claude Code | Codex |
  160. | --- | --- | --- |
  161. | User | `~/.claude/skills` | `${CODEX_HOME:-~/.codex}/skills` |
  162. | Current project | `.claude/skills` | `.codex/skills` |
  163. You will need Claude Code and/or Codex, depending on which agent you use. Some
  164. bundled deterministic tools, including `session-profiler`, require Python 3.
  165. ## Go deeper
  166. ### Native-agent orchestration
  167. `lead` and `lead-research` use the subagent tools provided by whichever runtime
  168. invokes them. They probe concurrency, isolation, messaging, shell, write, and web
  169. capabilities at the start of a run, then assign work by role. There are no model
  170. IDs or provider CLI commands to configure when switching between Codex and
  171. Claude Code. A runtime without native subagent delegation stops instead of
  172. letting the orchestrator write code or perform research itself.
  173. ### Profile an agent session
  174. After installation, point `SP` at the wrapper for Hermes:
  175. ```bash
  176. SP="${HERMES_HOME:-$HOME/.hermes}/skills/session-profiler/scripts/sp"
  177. ```
  178. Then explore your sessions:
  179. ```bash
  180. $SP list --provider hermes --n 20
  181. $SP info <session-id-or-jsonl-path>
  182. $SP parse <session-id-or-jsonl-path>
  183. $SP brief
  184. $SP agent-summary
  185. $SP costs
  186. $SP slowest-tools --n 20
  187. $SP errors
  188. $SP turns
  189. ```
  190. Generate richer artifacts:
  191. ```bash
  192. $SP toc
  193. $SP review
  194. $SP trace
  195. ```
  196. `brief` writes a scan-friendly `brief.md` with headline metrics, standout slow
  197. paths or failures, a prompt trail or TOC storyline, and an agent scoreboard. The
  198. Perfetto trace adds an overview lane, labeled TOC phases, per-agent work lanes,
  199. prompt lanes, and cumulative token/cost counters.
  200. Cost reports are estimates based on public model pricing, not billing records.
  201. Session files and traces can include prompts, code, file paths, and other
  202. sensitive project context. Review them before sharing.
  203. ## Repository map
  204. ```text
  205. skills/ The skill collection
  206. <skill>/SKILL.md Each skill's entry point and workflow
  207. assets/readme-hero.png README banner
  208. install.sh macOS/Linux installer
  209. install.ps1 Windows installer
  210. package.json npm package metadata and npx entrypoint
  211. bin/builder-essential-skills.js cross-platform npx installer
  212. ```
  213. ### Publish the installer
  214. Choose an available npm package name in `package.json`, authenticate with npm,
  215. then publish from the repository root:
  216. ```bash
  217. npm login
  218. npm publish --access public
  219. ```
  220. npm requires either 2FA enabled on the account, followed by the one-time code
  221. requested by `npm publish`, or a granular access token with read/write access
  222. and **Bypass two-factor authentication** enabled. For a local interactive
  223. publish, enabling 2FA and running `npm login` again is the simplest option.
  224. Never commit an access token; use npm's login flow or a secure CI secret.
  225. After publishing, users can run `npx @tamng0905/builder-essential-skills` without cloning the
  226. repository. Bump the version in `package.json` for each subsequent publish.
  227. ## Bring your own workflow
  228. Start with one folder:
  229. ```text
  230. skills/my-skill/
  231. SKILL.md
  232. ```
  233. Give `SKILL.md` clear frontmatter and a focused workflow:
  234. ```markdown
  235. ---
  236. name: my-skill
  237. description: Explain when an agent should use this skill.
  238. ---
  239. # My Skill
  240. Write the workflow, rules, examples, and expected output here.
  241. ```
  242. Keep skills easy to move between projects:
  243. - Avoid hard-coding a company, repository, branch, or tool unless the skill is intentionally private.
  244. - Put reusable scripts beside the skill instead of relying on global shell state.
  245. - Include request examples that show exactly when the skill should run.
  246. - Create `assets/skill-cards/<name>.svg` for each new skill and add it to the
  247. README's "Pick a skill" table.
  248. - Never put credentials, tokens, or private data in a skill folder.
  249. Re-run the installer after adding or changing a skill:
  250. ```bash
  251. ./install.sh
  252. ```
  253. ## License
  254. MIT. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

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