技能 skill-best-practices

📦

skill-best-practices

Name: skill-best-practices
Author: dboeckli

内容修订 r1 中风险 ⚙️ 外部命令📁 文件系统访问🌐 网络访问

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.

支持: Claude Codex Code(CC)

📊 72 合格

使用我的智能体安装

将此请求复制给你的智能体，其中包含权威 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.

你的智能体仍应展示其计划，并按安全策略请求必要确认。

Agent 可读资源

当 AI Agent、爬虫或脚本需要干净上下文，而不是读取完整页面时，请使用这些链接。

Markdown 详情 GET /skills/dboeckli-skill-best-practices.md 已签名 manifest GET /api/skills/dboeckli-skill-best-practices/manifest 已签名 lockfile GET /api/skills/dboeckli-skill-best-practices/lockfile

测试它

正在使用“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.

安全审计

中风险

v1 • 2026/9/26 打开版本化报告

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.

已扫描文件

675

分析行数

复核项

已忽略误报

已确认安全问题 (1)

中

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.

风险因素

⚙️ 外部命令 (50)

📁 文件系统访问 (4)

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

🌐 网络访问 (1)

SKILL.md:10

审计者: codex

分享与引用此报告

分享版本化评估报告、中性徽章、嵌入卡片和引用。Skillstore 只报告证据，不判断该 Skill 是否安全。

打开版本化报告

复制报告链接

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

Markdown 徽章

[![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 徽章

<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/1

BibTeX 引用

@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.

试试这些提示

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.