skill-best-practices
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.
自分のエージェントでインストール
このリクエストをエージェントにコピーしてください。正規の Skill ページとマニフェストが含まれています。
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.エージェントは引き続き計画を提示し、セキュリティポリシーで必要な確認を求める必要があります。
エージェントが読めるリソース
AI エージェント、クローラー、スクリプトがページ全体ではなく整理されたコンテキストを必要とする場合は、これらのリンクを使ってください。
テストする
「skill-best-practices」を使用しています。 Create a skill that plans sprints in Linear.
期待される結果:
A three-use-case plan with sprint triggers, ordered Linear actions, validation gates, error handling, and representative tests.
「skill-best-practices」を使用しています。 Review my skill because it rarely loads automatically.
期待される結果:
- 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」を使用しています。 Improve a large skill that consumes too much context.
期待される結果:
A concise core instruction file with detailed guidance moved into clearly linked references.
セキュリティ監査
中リスク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.
確認済みのセキュリティ上の懸念 (1)
リスク要因
⚙️ 外部コマンド (50)
📁 ファイルシステムへのアクセス (4)
🌐 ネットワークアクセス (1)
このレポートを共有・引用
バージョン付き評価レポート、中立的なバッジ、埋め込みカード、引用を共有できます。Skillstore は証拠を報告しますが、この Skill が安全かどうかは判断しません。
レポートリンクをコピー
https://skillstore.io/skills/dboeckli-skill-best-practices/audits/1?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportMarkdownバッジ
[](https://skillstore.io/skills/dboeckli-skill-best-practices?utm_source=security_passport_badge)HTMLバッジ
<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>埋め込みカード
<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>学術引用 (APA · BibTeX · CFF)
APA形式の引用
dboeckli. (2026). skill-best-practices security audit report (audit version 1) [Author version unspecified]. Skillstore. https://skillstore.io/skills/dboeckli-skill-best-practices/audits/1BibTeX形式の引用
@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 スコア
このスコアの理由 証拠の信頼度: 中作成できるもの
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.
これらのプロンプトを試す
Create a skill plan for [goal]. Define three use cases, trigger phrases, required tools, workflow steps, and expected results.
Rewrite this skill description: [description]. Include its purpose, specific trigger phrases, important capabilities, and clear exclusions.
Review [SKILL.md content]. Report pass, warning, or fail for frontmatter, triggers, instructions, examples, references, testing, and troubleshooting.
Design a multi-tool skill for [workflow]. Include dependencies, validation gates, rollback steps, tool selection rules, error handling, and test cases.
ベストプラクティス
- Define concrete use cases and trigger phrases before writing instructions.
- Keep core instructions concise and load detailed references only when needed.
- Test relevant, paraphrased, and unrelated requests before release.
回避
- Do not use vague descriptions that omit real user phrases.
- Do not bury critical validation steps below long background sections.
- Do not rely on prose when a deterministic validation script is available.
よくある質問
What files does a basic skill require?
How should the description be written?
How can I reduce unwanted triggering?
When should references be used?
Does the validator test skill quality?
Is remote validation fully offline?
開発者情報
作成者
dboeckliライセンス
MIT
Skillstore リビジョン
r1
バージョンに関する注意
作者はバージョンを宣言していません。
参照
1cda4003aa9ea65a9606af00b33e9c706ef03e62
メンテナンスの新しさ
2026/9/30
利用状況
0 ダウンロード · 0 閲覧
ファイル構成