@owlmeans/agent-skills 0.1.12 → 0.1.14

package/agent-meta/skills/self-education/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: self-education
+description: Mandatory post-development guidance updating — after functionality is added or changed, update the project skills/instructions the work touched, record external-doc findings (URL + gist) in the governing skill, or add skills/instructions for new subsystems and technologies. Required before the completion report whenever development started from a plan agreed with the agent.
+user-invocable: true
+scope: general
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# Self-education
+
+After functionality is added or changed, the guidance that describes it must catch up — the agent
+teaches itself for next time. This pass runs after implementation and verification, **before**
+the completion report.
+
+## When (mandatory)
+
+Development "started from planning" when the session produced a plan the operator approved before
+implementation — a plan-mode approval, an agreed written plan/spec, or an explicit "go ahead" on
+a proposed approach. **Approval of a plan is simultaneously approval of its implicit final step:
+this self-education pass.** A planned task is not finishable without it. If guidance files cannot
+be edited (read-only run), list the required updates in the report instead.
+
+Also recommended after any unplanned change that made an existing skill/instruction inaccurate.
+
+## Review checklist
+
+For each area the work touched:
+
+1. Which existing skill/instruction covers it? (Check `.claude/skills/` +
+   `.github/instructions/`.)
+2. Do its commands, paths, APIs, and behavior claims still hold after the change?
+3. Fix in place — and keep the skill and its instruction twin in sync.
+
+## Non-project skills
+
+If a general or imported skill gained an important usage pattern during the work, add the pattern
+to the **deployed copy** in this repo and note it in the report as an upstream candidate —
+canonical archive copies change only on explicit operator request.
+
+## External docs
+
+If the work required reading internet documentation for an external API, library, or service,
+the governing skill must record it under an `## External docs` heading:
+
+```
+- <URL> — <one-line gist of what it settled> (<version/date if load-bearing>)
+```
+
+Governing skill = the project skill covering the touched area; else the skill covering that
+library; if none exists and the technology will recur, create one (update-vs-create rule in
+`memory-promotion`). Never leave doc findings only in memory or the conversation.
+
+## New subsystems / technologies
+
+When new technology or a new subsystem entered the repo: create the skill/instruction pair for
+its procedures, and/or the `.agents/memory/` node for its facts — split along the
+memory-vs-skill boundary (`agent-memory` / `memory-promotion`).
+
+## Completion gate
+
+The completion report must contain a Self-education table:
+
+| Item | Action | Path |
+|---|---|---|
+| <area/skill> | updated / created / none-needed | <path> |
+
+"none-needed" requires a one-phrase reason. A post-plan completion report without this table is
+a protocol violation.

package/agent-meta/skills/skill-authoring/SKILL.md

@@ -65,7 +65,8 @@ skill").
 - **Skill / instruction** — a reusable procedure or reference you (or the tools) will want again,
   worth auto-invoking. Lives in `.claude/skills/` + `.github/instructions/`.
 - **Memory** — a fact, decision, or gotcha specific to this project's history/state. Lives in
-  `.claude/memory/` + `.github/memory/`. See the `agent-memory` skill.
+  the shared `.agents/memory/` graph store (both tools). See the `agent-memory` skill; promotion
+  triggers and the update-vs-create rule live in `memory-promotion`.
 
 If you find yourself writing "last time we…", that is memory. If you are writing "to do X, do Y",
 that is a skill.
@@ -73,7 +74,7 @@ that is a skill.
 ## After adding a skill
 
 1. If it replaces an ad-hoc `.claude/<topic>.md`, remove that file.
-2. Mention it in `.claude/memory/MEMORY.md` (and `.github/memory/MEMORY.md`) so future sessions know
-   it exists.
+2. If it absorbed memory content, shrink the source `.agents/memory/` node to a pointer line
+   (`memory-promotion`) — the memory index does not list skills.
 3. Reference it from `CLAUDE.md` / `.github/copilot-instructions.md` if it should be discoverable
    every session.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/agent-skills",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -26,10 +26,10 @@
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",
-    "@types/bun": "^1.3.0",
-    "@types/node": "^24.10.1",
-    "nodemon": "^3.1.11",
-    "typescript": "^6.0.2"
+    "@types/bun": "^1.3.14",
+    "@types/node": "^26.1.0",
+    "nodemon": "^3.1.14",
+    "typescript": "^6.0.3"
   },
   "publishConfig": {
     "access": "public"