update-package-skill Skill
✓ VerifiziertAktualisiert ein bestehendes Package Skill auf eine neue Version, indem Änderungen per Diff ermittelt und nur die betroffenen Zeilen getestet werden.
- GitHub Stars
- 331
- Dateien
- 2
- Letzter Commit
- 10. Okt. 2026
- Lizenz
- MIT
- Erlaubte Tools
- —
Was macht der update-package-skill Skill?
Aktualisiert ein bestehendes Package Skill auf eine neue Version, indem Änderungen per Diff ermittelt und nur die betroffenen Zeilen getestet werden.
Zusammenfassung erzeugt aus der SKILL.md des Skills.
Über den update-package-skill skill
Die Hauptfunktion dieses Tools ist das Aktualisieren bestehender Package Skills, um sie an neue Software-Releases anzupassen. Es ist für Maintainer gedacht, die ein Skill nach einem Package-Update auffrischen müssen oder wenn eine SKILL.md Datei auf eine veraltete Version verweist. Der Prozess funktioniert, indem die alte und neue Version eines npm- oder lokalen Packages gedifft werden, um spezifische Änderungen in Exports, Types, Options oder im Verhalten zu identifizieren.
Ein Agent sollte dieses Skill laden, wenn er Zugriff auf das Filesystem, die Shell und das Netzwerk hat. Anstatt ein Skill komplett neu zu schreiben, führt der Agent ein gezieltes Update durch, indem er die Änderungen den spezifischen Zeilen im bestehenden Skill zuordnet. Er nutzt Befehle wie npm diff, um Änderungen zu analysieren, und führt Tests nur auf den betroffenen Zeilen unter Verwendung eines Consumer Fixture und pnpm-workspace.yaml aus. Dieser Ansatz stellt sicher, dass unberührte Beispiele nicht unnötig erneut ausgeführt werden, was Zeit und Ressourcen spart und gleichzeitig die ursprüngliche Formatierung und Formulierung des Skills beibehält.
Was ein agent damit machen kann
- 1Veraltete Versionsdokumentation synchronisierenRepariere ein Skill, wenn die SKILL.md Datei eine Version nennt, die älter als die aktuelle Package-Version ist.
- 2Gezieltes Regression Testing durchführenVerifiziere, dass neue Package-Änderungen bestehende Claims nicht beschädigt haben, indem du Tests nur auf den betroffenen Zeilen ausführst.
Geschrieben basierend auf dem SKILL.md des skills. Jeder use case wurde gegen ein zitat daraus geprüft.
So installierst du den update-package-skill Skill
Jeder Befehl kopiert den Skill-Ordner in das Skills-Verzeichnis des Clients. Starte den Client neu oder beginne eine neue Session, um ihn zu laden.Den update-package-skill Skill in Plugin installieren
/plugin marketplace add skilld-dev/skilld /plugin install skilld@skilld
Den update-package-skill Skill in Claude Code installieren
~/.claude/skills/update-package-skill/SKILL.md
$ npx degit skilld-dev/skilld/skills/update-package-skill ~/.claude/skills/update-package-skillDen update-package-skill Skill in Claude Code (project) installieren
.claude/skills/update-package-skill/SKILL.md
$ npx degit skilld-dev/skilld/skills/update-package-skill .claude/skills/update-package-skillDen update-package-skill Skill in Codex installieren
~/.agents/skills/update-package-skill/SKILL.md
$ npx degit skilld-dev/skilld/skills/update-package-skill ~/.agents/skills/update-package-skillDen update-package-skill Skill in Gemini CLI installieren
~/.gemini/skills/update-package-skill/SKILL.md
$ npx degit skilld-dev/skilld/skills/update-package-skill ~/.gemini/skills/update-package-skillDen update-package-skill Skill in Claude.ai installieren
npx degit skilld-dev/skilld/skills/update-package-skill update-package-skill && zip -r update-package-skill.zip update-package-skill # claude.ai → Customize → Skills → + → Create skill → Upload a skill → update-package-skill.zip
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Hat unsere automatischen Prüfungen bestanden. Das ist kein Sicherheitsaudit: Lesen Sie die Skripte, bevor ein Agent sie ausführt. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarskilld-dev/skilld/skills/update-package-skill is public and reachablegithub.com/skilld-dev/skilld/tree/HEAD/skills/update-package ↗Bestanden
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit 2026-10-10github.com/skilld-dev/skilld/commits ↗Bestanden
- Keine Download-und-Ausführen-Muster oder Zugangsdatendiebstahl in SkriptenNo scripts in the skill folderBestanden
- Keine versteckten Anweisungen in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/skilld-dev/skilld/blob/HEAD/skills/update-package ↗Bestanden
- Vorab erlaubte Tools sind eingeschränktNo pre-approved tools; the agent asks before using onegithub.com/skilld-dev/skilld/blob/HEAD/skills/update-package ↗Bestanden
- SKILL.md folgt dem Agent-Skills-FormatValid name and description; says when to use it; 69 linesgithub.com/skilld-dev/skilld/blob/HEAD/skills/update-package ↗Bestanden
SKILL.md
Auf GitHub ansehenUpdate a package Skill
Bring an existing package Skill to a new package version with the smallest correct edit.
The current Skill was tested against an earlier version. Trust what the release did not touch.
To write a Skill from nothing, use generate-package-skill.
Inputs
- The current Skill directory, and the package at the new version: a name and version, a directory, or prepared source.
- The tested version is the version the Skill's first paragraph names. If it names none, stop and report that the Skill needs a full rewrite.
- If the tested version equals the new version, change nothing and report that.
1. Copy, then diff
- Copy the current Skill to the destination unchanged. Edit only the copy.
- Diff the two published versions:
npm diff --diff=PACKAGE@OLD --diff=PACKAGE@NEW. For a local package, diff the old tarball against the packed build. - Read the changelog or release notes between the two versions.
- List what changed for a consumer: exports, types, options and their defaults, config keys, error messages, CLI flags, peer ranges, engines, and behaviour the notes describe.
2. Map changes to the Skill
For each change, find the Skill lines it affects: a claim, an example, a trap, a version limit. A change is relevant when it affects a Skill line, or when it adds or breaks something an Agent would get wrong: a new trap, a renamed call, a new required setup step. Internals, refactors, and fixes the Skill never mentioned are not relevant.
If no change is relevant, leave the copy byte-identical and stop. Report "no change needed" with a one-line diff summary.
3. Test the affected lines
- Create one consumer fixture outside the package source, with its own
pnpm-workspace.yaml. Install the new version and the documented peers. - Run each affected example and claim, and each example you add. Compare output with the claim: return values, type errors, build logs, exit codes.
- Run each with one failure input as well, such as a bad option or an unreachable URL.
- Do not re-run untouched examples. The earlier version's tests cover them.
- Wrap every run in
timeout 120. Start servers from your own script, record each process ID you start, and stop only those. Never kill by port or withpkill -f. - Spend about 20 tool calls on testing. Report an affected claim you could not test as untested; never claim it passed.
4. Edit
- Change only affected lines, and add what the release needs: a new trap, an old call → new call row, a new common task.
- Delete lines the release made false, and version limits it fixed.
- Update the tested version in the first paragraph. Other version literals go stale; avoid them.
- Keep the wording, order, and formatting of untouched lines exactly. The diff must show only what the release changed.
- Update the description only when a trigger changed, such as a renamed export or a new config key.
Keep the format rules:
- The frontmatter contains
nameanddescription, with optionallicense,compatibility,metadata, andallowed-tools. The name matches the directory. - Preserve the source license. Keep
compatibilityonly for specific environment requirements, at most 500 characters. - Remove generic compatibility filler. Keep package version coverage in the body.
metadatamaps string keys to string values.allowed-toolsis an experimental space-separated string.- The description is one plain YAML line without double quotes, backticks, or
%. SKILL.mdstays under 500 lines. Write at most eight reference files, each linked fromSKILL.md.
5. Report
- The tested version, old → new, and the files you changed.
- Each changed line with the diff hunk or release note behind it.
- Each affected claim left untested.
- Each mismatch between the new docs and observed behaviour: example, documented result, observed result. These are package bugs.
For a direct run, show the Skill diff for review. A direct run has no Harness checks; never claim it passed them.
Dateien in diesem Skill
2update-package-skill Skill-Fragen
Wie installiere ich den update-package-skill Skill in Claude Code?
Führe npx degit skilld-dev/skilld/skills/update-package-skill ~/.claude/skills/update-package-skill aus. Claude Code lädt Skills aus ~/.claude/skills (alle Projekte) oder .claude/skills (ein Projekt) und nutzt einen Skill, wenn seine Beschreibung zur Aufgabe passt.
Welche Clients können den update-package-skill Skill nutzen?
Jeder Client, der das Agent Skills-Format liest: Claude Code, Codex, Gemini CLI und claude.ai (als ZIP hochladen). Skripte im Skill laufen nur dort, wo der Client Codeausführung erlaubt.
Was soll ich tun, wenn das Skill keine getestete Version nennt?
Wenn der erste Absatz des Skills keine getestete Version nennt, musst du den Vorgang abbrechen und melden, dass das Skill ein komplettes Rewrite erfordert.
Wie sollte ich das Testing handhaben, um effizient zu bleiben?
Führe nicht die unberührten Beispiele erneut aus, da die Tests der vorherigen Version diese bereits abdecken; teste nur die Zeilen, die durch die Änderungen betroffen sind.
Wie ist der Prozess, um Änderungen zwischen Package-Versionen zu identifizieren?
Du solltest die veröffentlichten Versionen mit npm diff oder durch den Vergleich lokaler Tarballs diffen und anschließend das Changelog oder die Release Notes lesen.