Habilidades skill-best-practices

📦

skill-best-practices

Name: skill-best-practices
Author: dboeckli

Revisión del contenido r1 Riesgo medio ⚙️ Comandos externos📁 Acceso al sistema de archivos🌐 Acceso a red

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.

Compatible con: Claude Codex Code(CC)

📊 72 Adecuado

Maintain this Skill? Claim it 📊 72 Adecuado

Instalar con mi Agente

Copia esta solicitud en tu Agente. Incluye la página canónica del Skill y el manifiesto.

Solicitud de 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.

Tu Agente debe seguir mostrando su plan y solicitar cualquier confirmación exigida por la política de seguridad.

Recursos legibles por agentes

Usa estos enlaces cuando un agente de IA, crawler o script necesite contexto limpio en vez de leer la página completa.

Detalle Markdown GET /skills/dboeckli-skill-best-practices.md Manifest firmado GET /api/skills/dboeckli-skill-best-practices/manifest Lockfile firmado GET /api/skills/dboeckli-skill-best-practices/lockfile

Pruébalo

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.

Auditoría de seguridad

Riesgo medio

v1 • 26/9/2026 Abrir el informe 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.

Archivos escaneados

675

Líneas analizadas

Elementos de revisión

Falsos positivos ignorados

Preocupaciones de seguridad confirmadas (1)

Medio

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.

Factores de riesgo

⚙️ Comandos externos (50)

📁 Acceso al sistema de archivos (4)

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

🌐 Acceso a red (1)

SKILL.md:10

Auditado por: codex

Compartir y citar este informe

Comparte el informe de evaluación versionado, la insignia neutral, la tarjeta insertable y las citas. Skillstore presenta evidencias sin decidir si este Skill es seguro.

Abrir el informe versionado

Copiar enlace del informe

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

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

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

Tarjeta para insertar

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

Citas académicas (APA · BibTeX · CFF)

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

Puntuación de Skillstore

Por qué esta puntuación Confianza de la evidencia: Medio

Arquitectura

Mantenibilidad

Contenido

Comunidad

Cumplimiento de la especificación

Lo que puedes crear

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.

Prueba estos 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.