Habilidades enact-docs-guide
📦

enact-docs-guide

v1.0.0 Revisão do conteúdo r1 Risco Médio ⚙️ Comandos externos🔑 Variáveis de ambiente

Criar guias de ferramentas Enact

Criar ferramentas Enact requer estrutura, esquemas, comandos e passos de publicação claros. Esta skill dá ao Claude, ao Codex e ao Claude Code uma referência compacta para autoria em Enact.

Suporta: Claude Codex Code(CC)
⚠️ 50 Ruim

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 "enact-docs-guide" from https://skillstore.io/skills/enactprotocol-enact-docs-guide.md and its manifest at https://skillstore.io/api/skills/enactprotocol-enact-docs-guide/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/enactprotocol-enact-docs-guide.md manifest assinado GET /api/skills/enactprotocol-enact-docs-guide/manifest lockfile assinado GET /api/skills/enactprotocol-enact-docs-guide/lockfile

Testar

Usando "enact-docs-guide". Preciso de uma visão geral rápida do que uma ferramenta Enact contém.

Resultado esperado:

Uma ferramenta Enact geralmente inclui um ficheiro enact.md e código-fonte. O guia explica metadados, esquemas, comandos, variáveis de ambiente e passos de publicação.

Usando "enact-docs-guide". Ajude-me a preparar uma ferramenta antes da publicação.

Resultado esperado:

  • Confirme se o nome, a descrição, o esquema de entrada e o esquema de saída estão completos.
  • Use uma imagem de container fixada e documente a instalação de dependências.
  • Teste a ferramenta localmente, depois assine-a e publique-a apenas após revisão.

Usando "enact-docs-guide". Como devo lidar com uma chave de API numa ferramenta Enact?

Resultado esperado:

Declare a variável como segredo nos metadados da ferramenta. Defina-a através do comando de ambiente do Enact e evite armazená-la em ficheiros de ambiente locais.

Auditoria de segurança

Risco Médio
v4 • 05/07/2026 Abrir o relatório versionado

Most static findings are false positives caused by Markdown code fences, inline code, placeholder API key examples, and checklist text. The remaining concern is documentation that shows direct shell parameter substitution without safety guidance, which can lead authors to create injection-prone Enact tools.

1
Arquivos analisados
215
Linhas analisadas
7
Itens de revisão
0
Falsos positivos ignorados

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

Médio
SKILL.md:111SKILL.md:126-156
Unsafe Command Substitution Guidance
The guide presents shell command templates that substitute user parameters directly into command strings without a warning about validation, quoting, or argv-style execution.
Multiple examples use ${input} or ${name} in shell command strings. The file is documentation, so the risk is indirect but credible for tool authors who copy the pattern.
Itens de revisão de capacidade (7)

Estas são capacidades locais reais que podem ser esperadas para esta habilidade, portanto exigem revisão, mas não são contabilizadas como comportamento malicioso confirmado.

Médio
SKILL.md:64-103
Ruby/shell backtick execution
```yaml
This Markdown template includes a shell command field using direct parameter substitution. It is documentation, but following it without quoting or argument separation can create command injection risk.
Médio
SKILL.md:111
Ruby/shell backtick execution
| `command` | No* | Shell command with `${param}` substitution |
The field reference describes shell commands with ${param} substitution. The guidance does not warn authors to validate inputs or avoid shell interpolation.
Médio
SKILL.md:126-130
Ruby/shell backtick execution
```yaml
This language example passes ${input} directly through a command string. The example is documentation, but it can teach an unsafe pattern if input is not escaped.
Médio
SKILL.md:133-137
Ruby/shell backtick execution
```yaml
This language example passes ${input} directly through a command string. The example is documentation, but it can teach an unsafe pattern if input is not escaped.
Médio
SKILL.md:140-144
Ruby/shell backtick execution
```yaml
This language example passes ${input} directly through a command string. The example is documentation, but it can teach an unsafe pattern if input is not escaped.
Médio
SKILL.md:147-151
Ruby/shell backtick execution
```yaml
This language example passes ${input} directly through a command string. The example is documentation, but it can teach an unsafe pattern if input is not escaped.
Médio
SKILL.md:154-156
Ruby/shell backtick execution
```yaml
The shell example interpolates ${name} into an echo command. Even simple shell examples should warn authors about quoting and attacker-controlled values.

Fatores de risco

⚙️ Comandos externos (46)
SKILL.md:44-52 SKILL.md:52-56 SKILL.md:56-60 SKILL.md:60-64 SKILL.md:64-103 SKILL.md:103-109 SKILL.md:109 SKILL.md:110-111 SKILL.md:111 SKILL.md:112 SKILL.md:113-114 SKILL.md:114-115 SKILL.md:115-116 SKILL.md:116 SKILL.md:117 SKILL.md:118-119 SKILL.md:119-121 SKILL.md:121-126 SKILL.md:126-130 SKILL.md:130-133 SKILL.md:133-137 SKILL.md:137-140 SKILL.md:140-144 SKILL.md:144-147 SKILL.md:147-151 SKILL.md:151-154 SKILL.md:154-156 SKILL.md:156-160 SKILL.md:160-162 SKILL.md:162-169 SKILL.md:169-173 SKILL.md:173-178 SKILL.md:178-180 SKILL.md:180-182 SKILL.md:182-186 SKILL.md:186-187 SKILL.md:187-191 SKILL.md:191-203 SKILL.md:203-207 SKILL.md:207-208 SKILL.md:208-209 SKILL.md:209-210 SKILL.md:210-211 SKILL.md:211 SKILL.md:212-213 SKILL.md:213
🔑 Variáveis de ambiente (5)
SKILL.md:182 SKILL.md:90 SKILL.md:175 SKILL.md:180 SKILL.md:182
Auditado por: codex Ver histórico de auditoria →
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
Avaliação de Segurança

Copiar link do relatório

https://skillstore.io/skills/enactprotocol-enact-docs-guide/audits/4?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Badge Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/enactprotocol-enact-docs-guide/security.svg)](https://skillstore.io/skills/enactprotocol-enact-docs-guide?utm_source=security_passport_badge)

Badge HTML

<a href="https://skillstore.io/skills/enactprotocol-enact-docs-guide?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/enactprotocol-enact-docs-guide/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Cartão incorporável

<iframe src="https://skillstore.io/embed/skills/enactprotocol-enact-docs-guide.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

EnactProtocol. (2026). enact-docs-guide security audit report (audit version 4) [Author version 1.0.0]. Skillstore. https://skillstore.io/skills/enactprotocol-enact-docs-guide/audits/4

Citação BibTeX

@techreport{enactprotocol-enactprotocol-enact-docs-guide-2026, author = {EnactProtocol}, title = {enact-docs-guide security audit report (audit version 4)}, institution = {Skillstore}, year = {2026}, number = {4}, url = {https://skillstore.io/skills/enactprotocol-enact-docs-guide/audits/4}, note = {Author version 1.0.0} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "enact-docs-guide security audit report (audit version 4)" version: "1.0.0" type: report authors: - name: "EnactProtocol" date-released: "2026-07-05" url: "https://skillstore.io/skills/enactprotocol-enact-docs-guide/audits/4" identifiers: - type: other value: "skillstore:enactprotocol-enact-docs-guide:audit:4" description: "Skillstore immutable audit report identifier"

Pontuação do Skillstore

Por que esta pontuação Confiança das evidências: Alto
55
Arquitetura
100
Manutenibilidade
87
Conteúdo
69
Comunidade
83
Conformidade com a especificação

O que você pode criar

Criar uma primeira ferramenta Enact

Use o guia para compreender os ficheiros obrigatórios, campos de metadados, esquemas e comando de teste local.

Preparar uma ferramenta para publicação

Revise os passos de assinatura, publicação, metadados e lista de verificação antes de partilhar uma ferramenta.

Ensinar convenções do Enact a agentes

Dê a um assistente de IA uma referência concisa para estrutura Enact, campos de comando e gestão de segredos.

Teste estes prompts

Explicar os fundamentos do Enact 
Explique a estrutura de ferramentas Enact usando este guia. Foque-se no objetivo de enact.md, nos ficheiros principais de código-fonte e na entrada e saída estruturadas.
Rascunhar um esboço de enact.md 
Ajude-me a esboçar um ficheiro enact.md para uma ferramenta que aceita uma entrada de texto e retorna um resultado de texto. Inclua campos obrigatórios e notas sobre esquemas.
Rever o design de uma ferramenta 
Reveja o meu plano de ferramenta Enact em relação à lista de verificação do guia. Identifique metadados em falta, lacunas de esquema, preocupações com comandos e passos de publicação.
Reforçar o uso de comandos e segredos 
Analise o meu campo command do Enact e o plano de variáveis de ambiente. Recomende tratamento de parâmetros mais seguro, armazenamento de segredos e validação antes da publicação.

Boas práticas

  • Use o guia como lista de verificação antes de executar ou publicar ferramentas Enact.
  • Valide entradas e saídas com esquemas antes de confiar no comportamento da ferramenta.
  • Trate exemplos de comandos e segredos como modelos que precisam de revisão específica do projeto.

Evitar

  • Não copie modelos de comandos sem verificar aspas e validação de entradas.
  • Não publique uma ferramenta antes de testar o seu esquema e a saída em runtime.
  • Não coloque segredos reais em documentação, prompts ou ficheiros de ambiente locais.

Perguntas frequentes

Em que esta skill ajuda?
Ajuda assistentes de IA a explicar a estrutura de ferramentas Enact, comandos, esquemas, segredos e workflow de publicação.
Ela cria automaticamente uma ferramenta completa?
Não. Fornece orientação e exemplos que podem apoiar a criação, revisão e preparação de publicação de ferramentas.
Claude, Codex e Claude Code podem usá-la?
Sim. O relatório lista suporte para Claude, Codex e Claude Code.
Ela executa comandos shell por conta própria?
Não. A skill é um guia em Markdown. Qualquer execução de comando deve exigir revisão e aprovação do utilizador.
Como ela descreve segredos?
Mostra metadados de segredos e recomenda definir valores secretos através do Enact em vez de armazená-los em ficheiros de ambiente.
O que os utilizadores devem rever cuidadosamente?
Os utilizadores devem rever cuidadosamente substituição de comandos, validação de entradas, instalação de dependências e permissões de publicação antes de usar exemplos.

Detalhes do desenvolvedor

Licença

MIT

Versão do autor

v1.0.0

Revisão da Skillstore

r1

Repositório

https://github.com/EnactProtocol/enact/tree/main/examples/guide

Referência

30c73eac2afe762f6aa9c4553158769369d47351

Atualidade da manutenção

22/07/2026

Uso

5 downloads · 135 visualizações

Estrutura de arquivos

📄 SKILL.md

Mais de EnactProtocol

Ver tudo

Habilidades relacionadas

Ver tudo