ethan-agent-skills 0.1.0 → 0.2.0

package/README.md

@@ -25,6 +25,9 @@ npx -y ethan-agent-skills@latest update --target /tmp/test-skills
 npx -y ethan-agent-skills@latest list
 ```
 
+Current common bundled skills include `pdf-extract`, `skill-evolution`,
+`fix-my-life`, and `smzdm-picks`, plus the client-specific OpenSpec OPSX skills.
+
 The updater writes `.skills-lock.json` in each target skill root and only
 rewrites skills managed by this package. If a destination skill directory exists
 but is not recorded in the lock file, the updater reports a conflict and leaves
@@ -88,8 +91,14 @@ npm login
 npm publish --access public
 ```
 
+### Automated Release Workflow
+
 This repo includes `.github/workflows/publish.yml` for automated publishing
-with npm Trusted Publishing. To enable it:
+with npm Trusted Publishing. The package `ethan-agent-skills@0.1.0` has already
+been published manually, so do not create or push a `v0.1.0` tag now. That tag
+would try to publish the same version again and fail.
+
+One-time setup:
 
 1. Push this repository to GitHub.
 2. On npmjs.com, open the package settings for `ethan-agent-skills`.
@@ -98,16 +107,159 @@ with npm Trusted Publishing. To enable it:
    - Organization or user: `EthenZhang`
    - Repository: `my_agent_skill`
    - Workflow filename: `publish.yml`
-4. Push a semver tag:
+Trusted Publishing uses GitHub OIDC, so no long-lived `NPM_TOKEN` secret is
+required.
+
+Normal release flow:
 
 ```bash
+npm run test:local
+npm run pack:check
 npm version patch
 git push --follow-tags
 ```
 
-The workflow runs validation and publishes to npm when tags matching `v*.*.*`
-are pushed. It can also be started manually from the GitHub Actions tab. Trusted
-Publishing uses GitHub OIDC, so no long-lived `NPM_TOKEN` secret is required.
+`npm version patch` updates `package.json` and `package-lock.json`, creates a
+commit, and creates a tag like `v0.1.1`. Pushing the tag triggers the workflow,
+which runs validation and publishes the tagged version to npm.
+
+### Publishing Skill Updates
+
+When you change a skill, a normal `git push origin main` only updates GitHub.
+It does not publish a new npm version. To make the change available through
+`npx -y ethan-agent-skills@latest update`, publish a new package version:
+
+```bash
+# Edit skill files first, then:
+npm run test:local
+npm run pack:check
+git add .
+git commit -m "Update <skill-name> skill"
+npm version patch
+git push --follow-tags
+```
+
+Use `patch` for routine skill edits and fixes. Use `minor` when adding a new
+skill or a meaningful new CLI capability. Use `major` only for breaking changes.
+
+After the GitHub Actions publish job succeeds, users can refresh local skills:
+
+```bash
+npx -y ethan-agent-skills@latest update
+```
+
+For minor or major releases, use:
+
+```bash
+npm version minor
+# or
+npm version major
+git push --follow-tags
+```
+
+If the workflow fails:
+
+- Check the GitHub Actions run logs first.
+- If npm says the version already exists, bump to a new version and push a new
+  tag.
+- If npm says trusted publishing is not configured, confirm the npm package
+  settings still point to `EthenZhang/my_agent_skill` and `publish.yml`.
+
+The workflow can also be started manually from the GitHub Actions tab, but tag
+pushes are the preferred release path because they tie npm versions to Git
+history.
+
+### Importing Existing Local Skills
+
+Use this flow when a useful skill already exists under a local agent directory
+such as `~/.claude/skills/<skill-dir>` and should become part of this package.
+
+1. Choose the package destination:
+   - Put cross-client skills in `skills/<skill-dir>`.
+   - Put Claude-only skills in `claude/skills/<skill-dir>`.
+   - Put Codex-only skills in `codex/skills/<skill-dir>`.
+   - Put source-command or agent-only skills in `agents/skills/<skill-dir>`.
+2. Inspect the source before copying:
+
+```bash
+SOURCE="$HOME/.claude/skills/<skill-dir>"
+rg --files -uu "$SOURCE"
+rg -n "(secret|password|token|api[_-]?key|PRIVATE|sk-[A-Za-z0-9])" "$SOURCE"
+```
+
+Do not copy real `.env` files, private keys, generated caches, or unrelated
+local state. Placeholder files such as `.env.example` are fine.
+
+3. Copy the skill into the package:
+
+```bash
+DEST="skills/<skill-dir>"
+rm -rf "$DEST"
+cp -R "$SOURCE" "$DEST"
+find "$DEST" -type d -name "__pycache__" -prune -exec rm -rf {} +
+find "$DEST" -name "*.pyc" -delete
+```
+
+4. Add or update `skill.json` beside `SKILL.md`:
+
+```json
+{
+  "name": "<trigger-or-display-name>",
+  "version": "0.1.0",
+  "description": "Short description used by the package list command."
+}
+```
+
+Keep the `SKILL.md` frontmatter name unchanged when the existing trigger name
+should remain stable. For example, a directory can be `skill-evolution` while
+the skill frontmatter name remains `skill-dev`.
+
+5. Verify local discovery and install behavior:
+
+```bash
+node bin/skills.mjs list
+node bin/skills.mjs update --dry-run --target /tmp/test-skills --client claude
+npm run test:local
+npm run pack:check
+```
+
+`npm run pack:check` should show the new `SKILL.md`, `skill.json`, references,
+and scripts in the tarball contents.
+
+6. Commit and push the imported skill:
+
+```bash
+git status --short
+git add README.md skills/<skill-dir>
+git commit -m "Add <skill-dir> skill"
+```
+
+Adjust the `git add` path if the skill was copied into `claude/`, `codex/`, or
+`agents/` instead of `skills/`.
+
+7. Publish a new npm version:
+
+```bash
+npm version minor
+git push --follow-tags
+```
+
+Use `minor` for adding a new skill. Use `patch` if the skill was already
+published and only its content changed.
+
+8. Confirm the automated release:
+
+```bash
+npm view ethan-agent-skills version --json
+npx -y ethan-agent-skills@latest list
+npx -y ethan-agent-skills@latest update --dry-run --target /tmp/test-skills --client claude
+```
+
+After the new version appears on npm, users can refresh with:
+
+```bash
+npx -y ethan-agent-skills@latest update
+```
 
 ## OpenSpec OPSX Usage
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ethan-agent-skills",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Agent skills published from my_agent_skill",
   "type": "module",
   "bin": {

package/skills/fix-my-life/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: fix-my-life
+description: Interactive life-fixing session. Use when user says "fix my life", "life review", "I'm stuck", "help me change", or "/fix-my-life".
+---
+
+# Fix My Life
+
+An interactive 3-phase session. Concise. Direct. No fluff.
+
+**Inspired by**: Dan Koe's "How to Fix Your Entire Life in 1 Day"
+
+---
+
+## Core Insight
+
+> You don't have bad habits. You have an identity that requires them.
+> Change the identity → behavior follows automatically.
+
+---
+
+## Flow
+
+```
+Phase 1: EXCAVATE   → Understand current state & hidden desires
+Phase 2: DESIGN     → Build the life game (vision + anti-vision)
+Phase 3: COMMIT     → Output the game plan
+```
+
+Each phase: ask → listen → reflect → move forward.
+
+---
+
+## Rules
+
+- Ask **one question at a time**
+- Wait for the answer before proceeding
+- Reflect back key insights in **1-2 sentences**
+- Use **lists** over paragraphs
+- Be direct. Comfort is the enemy here.
+- If answer is vague → ask one follow-up to sharpen it
+- Better utilize the USER.md file
+- Always use the user's language.
+
+---
+
+## Entry Point
+
+When invoked, say exactly:
+
+```
+**Fix My Life** — 3-phase session.
+
+Quick question first:
+What made you do this today? (1-3 words)
+```
+
+Then load and follow `phase-1-excavation.md`.

package/skills/fix-my-life/phase-1-excavation.md

@@ -0,0 +1,98 @@
+# Phase 1: Excavate
+
+**Goal**: Surface what's actually broken and what's actually wanted.
+
+**Time**: ~10 min of honest answers.
+
+---
+
+## Opening
+
+After getting the entry answer, say:
+
+```
+Good. Let's dig.
+
+I'll ask 5 questions. Short answers are fine.
+Honest answers are required.
+```
+
+---
+
+## The 5 Questions
+
+Ask one at a time. After each answer, reflect with 1 line before asking next.
+
+### Q1 — The Complaint Test
+```
+List your top 3 complaints about your life right now.
+(These are clues, not problems.)
+```
+
+*Why*: Complaints reveal what we value but aren't getting.
+
+---
+
+### Q2 — The Behavior Mirror
+```
+What do you spend most of your time on that you're not proud of?
+```
+
+*Why*: Behavior is honest. It shows your real identity.
+
+*If vague*: "Give me a specific example from yesterday."
+
+---
+
+### Q3 — The 5-Year Reel
+```
+If nothing changes — same habits, same identity, same choices —
+where are you in 5 years?
+
+Describe it in 3 bullets.
+```
+
+*Why*: Future-pain is the most honest motivator.
+
+---
+
+### Q4 — The Desire Beneath the Desire
+```
+What do you actually want?
+Not what you think you should want. What you actually want.
+```
+
+*If answer is surface-level* (e.g., "more money"):
+```
+Okay. What would "more money" give you that you don't have now?
+```
+
+Keep drilling until they hit something emotional.
+
+---
+
+### Q5 — The Identity Cost
+```
+If you became the person who achieves that — what would you have to give up?
+(Habits, relationships, beliefs, comfort zones)
+```
+
+*Why*: This is where resistance lives. Name it.
+
+---
+
+## Phase 1 Close
+
+After all 5 answers, summarize:
+
+```
+**What I'm hearing:**
+
+- Biggest gap: [their complaint → their desire, distilled]
+- Hidden fear: [what they'd have to give up]
+- The real problem: identity, not circumstance
+
+Ready for Phase 2?
+```
+
+Load `phase-2-design.md`.

package/skills/fix-my-life/phase-2-design.md

@@ -0,0 +1,141 @@
+# Phase 2: Design the Game
+
+**Goal**: Turn insights into a concrete game structure.
+
+**Framework**: Life is a video game. Structure it like one.
+
+---
+
+## Setup
+
+Say:
+```
+Now we build the game.
+
+Your life already has a win condition.
+You just haven't defined it clearly enough to play.
+```
+
+---
+
+## Step 1 — Anti-Vision (The Stakes)
+
+```
+Describe the life you absolutely refuse to live.
+3 years from now, worst case.
+
+Use "I am..." statements.
+```
+
+*Example output*:
+- I am still in the same job I hate
+- I am heavier, more tired, less alive
+- I am someone my past self would be disappointed by
+
+**After they answer**, reflect:
+```
+Good. That's your "Game Over" screen.
+Keep it visible. It's fuel.
+```
+
+---
+
+## Step 2 — Vision MVP (The Win Condition)
+
+```
+Now the opposite.
+
+3 years from now, if things go right:
+- What does your work look like? (1 line)
+- What does your body/health look like? (1 line)
+- What do your relationships look like? (1 line)
+- How do you feel when you wake up? (1 word)
+```
+
+*Keep it concrete. Not "be happy." "Wake up excited about my work."*
+
+**After they answer**, distill to:
+```
+**Your Win Condition**: [1-sentence synthesis]
+```
+
+---
+
+## Step 3 — Build the Quest Log
+
+### Main Quest (1 Year)
+```
+To move toward that 3-year vision —
+what's the ONE thing you could accomplish this year
+that would make everything else easier?
+```
+
+*Must be specific and measurable.*
+
+---
+
+### Boss Fight (This Month)
+```
+What project, if completed this month,
+would be the biggest step toward that 1-year goal?
+```
+
+---
+
+### Daily Quests (This Week)
+```
+Name 3 daily actions that move the needle.
+
+Format: [action] → [outcome it creates]
+```
+
+*Example*:
+- Write 500 words → builds the book
+- No phone before 9am → protects deep work
+- 30 min walk → clears head, resets energy
+
+---
+
+### Rules (Personal Constraints)
+```
+What are 2-3 rules you need to protect your progress?
+
+Format: "I don't [behavior]" or "I always [behavior]"
+```
+
+*Example*:
+- I don't check messages before 10am
+- I always ship something before consuming content
+
+---
+
+## Phase 2 Close
+
+Compile their full game:
+
+```
+**YOUR LIFE GAME**
+
+🏆 Win Condition: [their 3-year vision]
+💀 Game Over: [their anti-vision]
+
+🗺️ Main Quest (1 year): [their 1-year goal]
+⚔️ Boss Fight (this month): [their monthly project]
+
+📋 Daily Quests:
+- [action 1]
+- [action 2]
+- [action 3]
+
+📜 Rules:
+- [rule 1]
+- [rule 2]
+```
+
+Then say:
+```
+One phase left. The hardest one.
+Ready?
+```
+
+Load `phase-3-commit.md`.

package/skills/fix-my-life/phase-3-commit.md

@@ -0,0 +1,124 @@
+# Phase 3: Commit
+
+**Goal**: Convert the game plan into a saved document + one immediate action.
+
+---
+
+## The Commitment Problem
+
+Most people fail here. Not because of bad plans.
+Because they never commit to the identity behind the plan.
+
+Say:
+```
+The game is designed. Now the real question:
+
+Who do you need to become to win this game?
+
+Name that person in 3 words or less.
+(Example: "focused creator", "disciplined builder", "present father")
+```
+
+---
+
+## Identity Lock
+
+After they answer, say:
+```
+From now on, every decision runs through one filter:
+
+"What would [their 3 words] do here?"
+
+That's it. That's the whole system.
+```
+
+---
+
+## The One Action
+
+```
+What's ONE thing you can do in the next 24 hours
+that signals — to yourself — that you're now playing this game?
+
+Not a big thing. A real thing.
+```
+
+*Must be specific. "Start journaling" is not specific. "Write 3 sentences tonight" is.*
+
+---
+
+## Save the Game
+
+Say:
+```
+I'll save this as your Game Plan.
+Want me to save it to your workspace?
+```
+
+If yes → write to `workspace/outputs/life-game-{YYYY-MM-DD}.md` with this template:
+
+```markdown
+# Life Game — {date}
+
+## Identity
+**I am**: {their 3 words}
+
+## Stakes
+**Win**: {3-year vision}
+**Game Over**: {anti-vision}
+
+## Quest Log
+
+| Quest | Description |
+|-------|-------------|
+| Main Quest (1 year) | {1-year goal} |
+| Boss Fight (this month) | {monthly project} |
+| Daily Quest 1 | {action} → {outcome} |
+| Daily Quest 2 | {action} → {outcome} |
+| Daily Quest 3 | {action} → {outcome} |
+
+## Rules
+{rules as bullet list}
+
+## Next Action (24h)
+- [ ] {their one action}
+
+---
+*Generated by fix-my-life skill*
+```
+
+---
+
+## Closing
+
+After saving (or if they decline), say:
+
+```
+**Session complete.**
+
+What you did today:
+- Named what's broken (most people never do this)
+- Designed a system, not just a goal
+- Committed to an identity
+
+The gap between who you are and who you want to be
+is just a series of daily quests.
+
+Start yours today.
+```
+
+---
+
+## Optional: Weekly Check-in
+
+If they want accountability, say:
+```
+One more thing — set a reminder for 7 days from now.
+
+Ask yourself:
+- Did I run my daily quests?
+- Did I make progress on the boss fight?
+- Did I act like [their identity]?
+
+That's the whole review. Keep it short. Keep playing.
+```

package/skills/fix-my-life/skill.json

@@ -0,0 +1,5 @@
+{
+  "name": "fix-my-life",
+  "version": "0.1.0",
+  "description": "Interactive life-fixing session for life reviews, stuck states, personal change, and /fix-my-life."
+}