Personal vs project skills

Skills können sich an einem von drei Orten befinden: persönlich, projektbezogen oder als Plugin.

Persönliche Skills befinden sich in ~/.claude/skills/<skill-name>/SKILL.md und sind in allen Ihren Projekten verfügbar. Projektspezifische Skills werden in .claude/skills/<skill-name>/SKILL.md im Projektverzeichnis gespeichert. Diese Projekt-Skills sind zur Versionskontrolle vorgesehen und somit für Ihr Team zugänglich. Plugin-Skills befinden sich in der Verzeichnisstruktur eines Plugins unter <plugin>/skills/<skill-name>/SKILL.md.

Wenn Skills an diesen Orten denselben Namen haben, wird die Priorität wie folgt bestimmt: Unternehmens-Skills überschreiben persönliche Skills, und persönliche Skills überschreiben Projekt-Skills. Skills auf jeder dieser Ebenen haben auch Vorrang vor gebündelten Skills mit demselben Namen. Beispielsweise ersetzt ein benutzerdefinierter Code-Review-Skill im .claude/skills/-Verzeichnis Ihres Projekts die standardmäßig gebündelte Version.

Plugin-Skills verwenden einen plugin-name:skill-name-Namespace, der Namenskonflikte mit Skills auf anderen Ebenen verhindert. Projekt-Skills werden aus .claude/skills/-Verzeichnissen geladen, beginnend mit Ihrem aktuellen Arbeitsverzeichnis und aufwärts durch übergeordnete Verzeichnisse bis zum Stammverzeichnis des Repositories. Dies stellt sicher, dass Skills, die auf Repository-Ebene definiert sind, auch bei der Arbeit in Unterverzeichnissen zugänglich sind.

Skills können auch bei Bedarf aus verschachtelten .claude/skills/-Verzeichnissen geladen werden. Wenn Claude mit Dateien in einem Unterverzeichnis interagiert, werden alle Skills innerhalb des .claude/skills/-Verzeichnisses dieses Unterverzeichnisses verfügbar. Dieser Mechanismus ist besonders nützlich in Monorepos, wo einzelne Pakete ihre eigenen Skills bereitstellen können. Wenn ein verschachtelter Skill denselben Namen wie ein anderer Skill hat, bleiben beide verfügbar, und der verschachtelte Skill wird über seinen Pfad referenziert, z. B. /apps/web:deploy.

Ein <skill-name>-Eintrag kann auch ein symbolischer Link zu einem Verzeichnis sein, das sich an anderer Stelle auf Ihrem Dateisystem befindet. Eine Ausnahme von den üblichen Dateizugriffsregeln tritt mit dem --add-dir-Flag und dem /add-dir-Befehl auf: Ein .claude/skills/-Verzeichnis innerhalb eines hinzugefügten Verzeichnisses wird automatisch geladen, im Gegensatz zu Verzeichnissen, die über die Einstellung permissions.additionalDirectories hinzugefügt werden.