# Build Enact Tool Guides

Creating Enact tools requires clear structure, schemas, commands, and publishing steps. This skill gives Claude, Codex, and Claude Code a compact reference for Enact authoring.

## Install

```bash
npx skillstore add enactprotocol/enact-docs-guide
```

## Metadata

- Status: approved
- Slug: enactprotocol-enact-docs-guide
- Version: 1.0.0
- Author version: 1.0.0
- Skillstore revision: r1
- Version status: valid
- Tree hash: 3b393855a96621033bca34cf95a388179e35ec640b37c21652bb228e56a4cf74
- Author: EnactProtocol
- GitHub username: EnactProtocol
- License: MIT
- Repository: https://github.com/EnactProtocol/enact/tree/main/examples/guide
- Ref: 30c73eac2afe762f6aa9c4553158769369d47351
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, env\_access
- Quality score: 50
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/enactprotocol-enact-docs-guide
- Manifest: https://skillstore.pages.dev/api/skills/enactprotocol-enact-docs-guide/manifest

## Capabilities

- Explains the basic Enact tool folder structure and required enact.md file.
- Summarizes commands for running, installing, searching, signing, and publishing tools.
- Shows a reusable enact.md template with input schema, output schema, environment, and metadata fields.
- Compares Python, Node.js, Rust, Go, and shell command examples for container tools.
- Describes secret declaration and keyring-based setup for tool environment variables.
- Provides a short checklist for validating tool metadata before publishing.

## Use Cases

- Create a first Enact tool: Use the guide to understand the required files, metadata fields, schemas, and local test command.
- Prepare a tool for publishing: Review the signing, publishing, metadata, and checklist steps before sharing a tool.
- Teach agents Enact conventions: Give an AI assistant a concise reference for Enact structure, command fields, and secret handling.

## Prompt Templates

### Explain Enact basics

```
Explain the Enact tool structure using this guide. Focus on the purpose of enact.md, main source files, and structured input and output.
```

### Draft an enact.md outline

```
Help me outline an enact.md file for a tool that accepts one text input and returns one text result. Include required fields and schema notes.
```

### Review a tool design

```
Review my Enact tool plan against the guide checklist. Identify missing metadata, schema gaps, command concerns, and publishing steps.
```

### Harden command and secret usage

```
Analyze my Enact command field and environment variable plan. Recommend safer parameter handling, secret storage, and validation before publishing.
```

## Limitations

- It is a reference guide, not a complete Enact project generator.
- It does not verify that commands are safe for a specific host or repository.
- It does not replace the official Enact documentation or release notes.
- It does not validate published tools or marketplace permissions.

## Best Practices

- Use the guide as a checklist before running or publishing Enact tools.
- Validate inputs and outputs with schemas before relying on tool behavior.
- Treat command and secret examples as templates that need project-specific review.

## Anti Patterns

- Do not copy command templates without checking quoting and input validation.
- Do not publish a tool before testing its schema and runtime output.
- Do not place real secrets in documentation, prompts, or local environment files.

## Security Audit

- Audited at: 2026-07-05T15:48:35.024\+00:00
- Summary: 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.

## Stats

- Views: 135
- Downloads: 9
- Favorites: 0
- Popularity score: 0