Habilidades skill-best-practices

📦

skill-best-practices

Name: skill-best-practices
Author: dboeckli

Revisão do conteúdo r1 Risco Médio ⚙️ Comandos externos📁 Acesso ao sistema de arquivos🌐 Acesso à rede

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.

Suporta: Claude Codex Code(CC)

📊 72 Adequado

Instalar com meu Agente

Copie esta solicitação para o seu Agente. Ela inclui a página canônica do Skill e o manifesto.

Solicitação do agente

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.

Seu Agente ainda deve apresentar o plano e solicitar qualquer confirmação exigida pela política de segurança.

Recursos legíveis por agentes

Use estes links quando um agente de IA, crawler ou script precisar de contexto limpo em vez de ler a página completa.

Detalhe em Markdown GET /skills/dboeckli-skill-best-practices.md manifest assinado GET /api/skills/dboeckli-skill-best-practices/manifest lockfile assinado GET /api/skills/dboeckli-skill-best-practices/lockfile

Testar

Usando "skill-best-practices". Create a skill that plans sprints in Linear.

Resultado esperado:

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

Usando "skill-best-practices". Review my skill because it rarely loads automatically.

Resultado esperado:

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.

Usando "skill-best-practices". Improve a large skill that consumes too much context.

Resultado esperado:

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

Auditoria de segurança

Risco Médio

v1 • 26/09/2026 Abrir o relatório versionado

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.

Arquivos analisados

675

Linhas analisadas

Itens de revisão

Falsos positivos ignorados

Preocupações de segurança confirmadas (1)

Médio

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.

Fatores de risco

⚙️ Comandos externos (50)

📁 Acesso ao sistema de arquivos (4)

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

🌐 Acesso à rede (1)

SKILL.md:10

Auditado por: codex

Compartilhar e citar este relatório

Compartilhe o relatório de avaliação versionado, o badge neutro, o cartão incorporável e as citações. A Skillstore apresenta evidências sem decidir se este Skill é seguro.

Abrir o relatório versionado

Copiar link do relatório

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

Badge 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)

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>

Cartão incorporável

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

Citações acadêmicas (APA · BibTeX · CFF)

Citação 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

Citação 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"

Pontuação do Skillstore

Por que esta pontuação Confiança das evidências: Médio

Arquitetura

Manutenibilidade

Conteúdo

Comunidade

Conformidade com a especificação

O que você pode criar

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.

Teste estes prompts

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.