@tamng0905/builder-essential-skills 0.1.0 → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tam Nguyen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -7,44 +7,67 @@
 </p>
 
 <p align="center">
+  <a href="#install">Install</a> ·
   <a href="#pick-a-skill">Pick a skill</a> ·
-  <a href="#get-started">Get started</a> ·
   <a href="#bring-your-own-workflow">Create a skill</a>
 </p>
 
+## Install
+
+Install every skill for your user account:
+
+```bash
+npx @tamng0905/builder-essential-skills
+```
+
+Install into the repository you are currently in:
+
+```bash
+npx @tamng0905/builder-essential-skills --project
+```
+
+Install only one skill:
+
+```bash
+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.
+
 ## Pick a skill
 
 <table>
   <tr>
     <td width="50%" valign="top">
-      <a href="skills/lead/SKILL.md"><img src="assets/skill-cards/lead.svg" alt="lead — build and delivery skill" width="100%"></a>
+      <a href="skills/lead/SKILL.md"><img src="assets/skill-banners/lead.webp" alt="lead — build and delivery skill" width="100%"></a>
     </td>
     <td width="50%" valign="top">
-      <a href="skills/lead-research/SKILL.md"><img src="assets/skill-cards/lead-research.svg" alt="lead-research — research and strategy skill" width="100%"></a>
+      <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>
     </td>
   </tr>
   <tr>
     <td width="50%" valign="top">
-      <a href="skills/async-learning-teacher/SKILL.md"><img src="assets/skill-cards/async-learning-teacher.svg" alt="async-learning-teacher — learning skill" width="100%"></a>
+      <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>
     </td>
     <td width="50%" valign="top">
-      <a href="skills/validate-market/SKILL.md"><img src="assets/skill-cards/validate-market.svg" alt="validate-market — product and market skill" width="100%"></a>
+      <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>
     </td>
   </tr>
   <tr>
     <td width="50%" valign="top">
-      <a href="skills/write-blog/SKILL.md"><img src="assets/skill-cards/write-blog.svg" alt="write-blog — writing and growth skill" width="100%"></a>
+      <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>
     </td>
     <td width="50%" valign="top">
-      <a href="skills/orwell-writing/SKILL.md"><img src="assets/skill-cards/orwell-writing.svg" alt="orwell-writing — direct writing skill" width="100%"></a>
+      <a href="skills/orwell-writing/SKILL.md"><img src="assets/skill-banners/orwell-writing.webp" alt="orwell-writing — direct writing skill" width="100%"></a>
     </td>
   </tr>
   <tr>
     <td width="50%" valign="top">
-      <a href="skills/code-standards/SKILL.md"><img src="assets/skill-cards/code-standards.svg" alt="code-standards — engineering quality skill" width="100%"></a>
+      <a href="skills/code-standards/SKILL.md"><img src="assets/skill-banners/code-standards.webp" alt="code-standards — engineering quality skill" width="100%"></a>
     </td>
     <td width="50%" valign="top">
-      <a href="skills/session-profiler/SKILL.md"><img src="assets/skill-cards/session-profiler.svg" alt="session-profiler — developer tools skill" width="100%"></a>
+      <a href="skills/session-profiler/SKILL.md"><img src="assets/skill-banners/session-profiler.webp" alt="session-profiler — developer tools skill" width="100%"></a>
     </td>
   </tr>
 </table>
@@ -61,7 +84,9 @@ adapt, and share.
 
 Use the whole collection, or take only the skills your team needs.
 
-## Get started
+## Local install
+
+Use the local scripts only when you are installing from a cloned checkout.
 
 From the repository root, install every skill for the current user:
 
@@ -69,28 +94,6 @@ From the repository root, install every skill for the current user:
 ./install.sh
 ```
 
-Once this repository is published to npm, install the collection from
-anywhere with:
-
-```bash
-npx @tamng0905/builder-essential-skills
-```
-
-To install into the repository you are currently in:
-
-```bash
-npx @tamng0905/builder-essential-skills --project
-```
-
-To install only one skill:
-
-```bash
-npx @tamng0905/builder-essential-skills --skill lead
-```
-
-Add `--project` to that command to install the selected skill into the current
-repository.
-
 The `npx` command installs the same files as the scripts below. It supports
 macOS, Linux, and Windows wherever Node.js 18 or newer is available.
 
@@ -272,5 +275,4 @@ Re-run the installer after adding or changing a skill:
 
 ## License
 
-Add the license that matches how you want others to use this collection before
-publishing it broadly.
+MIT. See [LICENSE](LICENSE).

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@tamng0905/builder-essential-skills",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Builder's Essential Skills — reusable workflows for Claude Code and Codex",
+  "license": "MIT",
   "type": "commonjs",
   "scripts": {
     "test": "node --test"
@@ -16,6 +17,7 @@
     ".claude/agents",
     "install.ps1",
     "install.sh",
+    "LICENSE",
     "README.md"
   ],
   "engines": {

package/skills/async-learning-teacher/README.md

@@ -1,7 +1,7 @@
 # Async Learning Teacher
 
 <p align="center">
-  <img src="../../assets/skill-cards/async-learning-teacher.svg" alt="async-learning-teacher skill card" width="100%">
+  <a href="SKILL.md"><img src="../../assets/skill-banners/async-learning-teacher.webp" alt="async-learning-teacher — learning skill" width="100%"></a>
 </p>
 
 ## Install

package/skills/code-standards/README.md

@@ -1,7 +1,7 @@
 # Code Standards
 
 <p align="center">
-  <img src="../../assets/skill-cards/code-standards.svg" alt="code-standards skill card" width="100%">
+  <a href="SKILL.md"><img src="../../assets/skill-banners/code-standards.webp" alt="code-standards — engineering quality skill" width="100%"></a>
 </p>
 
 Apply a disciplined workflow to code changes: orient, establish a baseline,

package/skills/lead/README.md

@@ -1,7 +1,7 @@
 # Lead
 
 <p align="center">
-  <img src="../../assets/skill-cards/lead.svg" alt="lead skill card" width="100%">
+  <a href="SKILL.md"><img src="../../assets/skill-banners/lead.webp" alt="lead — build and delivery skill" width="100%"></a>
 </p>
 
 Run the autonomous build factory: turn a goal into an approved plan, freeze

package/skills/lead-research/README.md

@@ -1,7 +1,7 @@
 # Lead Research
 
 <p align="center">
-  <img src="../../assets/skill-cards/lead-research.svg" alt="lead-research skill card" width="100%">
+  <a href="SKILL.md"><img src="../../assets/skill-banners/lead-research.webp" alt="lead-research — research and strategy skill" width="100%"></a>
 </p>
 
 Map a topic cheaply, design parallel research assignments, verify claims

package/skills/orwell-writing/README.md

@@ -1,7 +1,7 @@
 # Orwell Writing
 
 <p align="center">
-  <img src="../../assets/skill-cards/orwell-writing.svg" alt="orwell-writing skill card" width="100%">
+  <a href="SKILL.md"><img src="../../assets/skill-banners/orwell-writing.webp" alt="orwell-writing — direct writing skill" width="100%"></a>
 </p>
 
 Draft, revise, and polish prose in plain English while preserving the intended

package/skills/session-profiler/README.md

@@ -1,7 +1,7 @@
 # Session Profiler
 
 <p align="center">
-  <img src="../../assets/skill-cards/session-profiler.svg" alt="session-profiler skill card" width="100%">
+  <a href="SKILL.md"><img src="../../assets/skill-banners/session-profiler.webp" alt="session-profiler — developer tools skill" width="100%"></a>
 </p>
 
 Inspect Claude Code and Codex session transcripts, summarize agent activity,

package/skills/validate-market/README.md

@@ -1,7 +1,7 @@
 # Validate Market
 
 <p align="center">
-  <img src="../../assets/skill-cards/validate-market.svg" alt="validate-market skill card" width="100%">
+  <a href="SKILL.md"><img src="../../assets/skill-banners/validate-market.webp" alt="validate-market — product and market skill" width="100%"></a>
 </p>
 
 Run an honest market-fit and viability audit that compares competitors, tests

package/skills/write-blog/README.md

@@ -1,7 +1,7 @@
 # Write Blog
 
 <p align="center">
-  <img src="../../assets/skill-cards/write-blog.svg" alt="write-blog skill card" width="100%">
+  <a href="SKILL.md"><img src="../../assets/skill-banners/write-blog.webp" alt="write-blog — writing and growth skill" width="100%"></a>
 </p>
 
 Write and ship a human-sounding blog post that targets search traffic, avoids