Fähigkeiten skill-best-practices

📦

skill-best-practices

Name: skill-best-practices
Author: dboeckli

Inhaltsrevision r1 Mittleres Risiko ⚙️ Externe Befehle📁 Dateisystemzugriff🌐 Netzwerkzugriff

Build Better AI Skills

AI skills often fail because triggers, structure, and validation are unclear. This guide provides practical patterns for reliable SKILL.md design, testing, and maintenance.

Unterstützt: Claude Codex Code(CC)

📊 72 Angemessen

Maintain this Skill? Claim it 📊 72 Angemessen

Mit meinem Agent installieren

Kopieren Sie diese Anfrage in Ihren Agent. Sie enthält die maßgebliche Skill-Seite und das Manifest.

Agent-Anfrage

Review the Skillstore skill "skill-best-practices" from https://skillstore.io/skills/dboeckli-skill-best-practices.md and its manifest at https://skillstore.io/api/skills/dboeckli-skill-best-practices/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

Ihr Agent sollte weiterhin seinen Plan anzeigen und alle von der Sicherheitsrichtlinie verlangten Bestätigungen anfordern.

Agent-lesbare Ressourcen

Verwenden Sie diese Links, wenn ein KI-Agent, Crawler oder Skript sauberen Kontext benötigt, statt die vollständige Seite zu lesen.

Markdown-Detailseite GET /skills/dboeckli-skill-best-practices.md Signiertes manifest GET /api/skills/dboeckli-skill-best-practices/manifest Signiertes lockfile GET /api/skills/dboeckli-skill-best-practices/lockfile

Testen

„skill-best-practices“ wird verwendet. Create a skill that plans sprints in Linear.

Erwartetes Ergebnis:

A three-use-case plan with sprint triggers, ordered Linear actions, validation gates, error handling, and representative tests.

„skill-best-practices“ wird verwendet. Review my skill because it rarely loads automatically.

Erwartetes Ergebnis:

Fail: The description does not include phrases users commonly enter.
Warning: The scope is broad and lacks negative triggers.
Fix: Add task-specific phrases, exclusions, and ten paraphrased trigger tests.

„skill-best-practices“ wird verwendet. Improve a large skill that consumes too much context.

Erwartetes Ergebnis:

A concise core instruction file with detailed guidance moved into clearly linked references.

Sicherheitsaudit

Mittleres Risiko

v1 • 26.9.2026 Versionsbericht öffnen

All 91 static alerts are false positives caused by Markdown formatting, bounded local validation, or ordinary path handling. No prompt injection or malicious intent was found. Remote validation still has a medium supply-chain risk because it executes an unpinned npm package.

Gescannte Dateien

675

Analysierte Zeilen

Prüfelemente

Falschmeldungen ignoriert

Bestätigte Sicherheitsbedenken (1)

Mittel

scripts/validate-skills.sh:74

Unpinned Remote Package Execution

Remote validation uses npx with automatic approval and no package version. Registry changes could execute code that was not reviewed with this skill.

Line 74 directly runs the unversioned skills package through npx --yes. The remote mode therefore trusts the current registry release.

Risikofaktoren

⚙️ Externe Befehle (50)

📁 Dateisystemzugriff (4)

scripts/validate-skills.sh:13 scripts/validate-skills.sh:12 scripts/validate-skills.sh:63 scripts/validate-skills.sh:71

🌐 Netzwerkzugriff (1)

SKILL.md:10

Geprüft von: codex

Diesen Bericht teilen & zitieren

Teile den versionierten Bewertungsbericht, das neutrale Badge, die Einbettungskarte und Zitate. Skillstore berichtet Nachweise, ohne zu entscheiden, ob dieser Skill sicher ist.

Versionsbericht öffnen

Berichtslink kopieren

https://skillstore.io/skills/dboeckli-skill-best-practices/audits/1?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown-Badge

[![Skillstore security assessment](https://skillstore.io/badges/skills/dboeckli-skill-best-practices/security.svg)](https://skillstore.io/skills/dboeckli-skill-best-practices?utm_source=security_passport_badge)

HTML-Badge

<a href="https://skillstore.io/skills/dboeckli-skill-best-practices?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/dboeckli-skill-best-practices/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Einbettungskarte

<iframe src="https://skillstore.io/embed/skills/dboeckli-skill-best-practices.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

Wissenschaftliche Zitate (APA · BibTeX · CFF)

APA-Zitat

dboeckli. (2026). skill-best-practices security audit report (audit version 1) [Author version unspecified]. Skillstore. https://skillstore.io/skills/dboeckli-skill-best-practices/audits/1

BibTeX-Zitat

@techreport{dboeckli-dboeckli-skill-best-practices-2026,
  author = {dboeckli},
  title = {skill-best-practices security audit report (audit version 1)},
  institution = {Skillstore},
  year = {2026},
  number = {1},
  url = {https://skillstore.io/skills/dboeckli-skill-best-practices/audits/1},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "skill-best-practices security audit report (audit version 1)"
version: "unspecified"
type: report
authors:
  - name: "dboeckli"
date-released: "2026-09-26"
url: "https://skillstore.io/skills/dboeckli-skill-best-practices/audits/1"
identifiers:
  - type: other
    value: "skillstore:dboeckli-skill-best-practices:audit:1"
    description: "Skillstore immutable audit report identifier"

Skillstore-Score

Warum dieser Score Evidenzvertrauen: Mittel

Architektur

Wartbarkeit

Inhalt

Gemeinschaft

Spezifikationskonformität

Was Sie erstellen können

Create a New Skill

Turn a workflow idea into a structured skill with clear triggers, instructions, examples, and validation steps.

Review an Existing Skill

Evaluate frontmatter, instruction quality, progressive disclosure, testing coverage, and troubleshooting guidance.

Fix Trigger Behavior

Refine descriptions and negative triggers when a skill loads too rarely or on unrelated requests.

Diese Prompts ausprobieren

Plan a Basic Skill

Create a skill plan for [goal]. Define three use cases, trigger phrases, required tools, workflow steps, and expected results.

Write a Skill Description

Rewrite this skill description: [description]. Include its purpose, specific trigger phrases, important capabilities, and clear exclusions.

Audit a SKILL.md File

Review [SKILL.md content]. Report pass, warning, or fail for frontmatter, triggers, instructions, examples, references, testing, and troubleshooting.

Design an Advanced Workflow

Design a multi-tool skill for [workflow]. Include dependencies, validation gates, rollback steps, tool selection rules, error handling, and test cases.