skills.rest
agent-sh
agent-shOFFICIAL
Explore all skills by this author →
Website𝕏@avi_feneshGitHub

enhance-agent-prompts

Analyze agent prompt files and output structured best-practice improvement reports.

951|110|Updated Jan 15, 2026
Search Tags:#validation#safety#engineering#prompts#tools#frontmatter#prompt
One-click install
npx skills add https://github.com/agent-sh/agentsys --skill enhance-agent-prompts-agent-sh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: enhance-agent-prompts
Source: https://github.com/agent-sh/agentsys/tree/main/.kiro/skills/enhance-agent-prompts
Command: npx skills add https://github.com/agent-sh/agentsys --skill enhance-agent-prompts-agent-sh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Refine and normalize agent prompt files to align with prompt-engineering best practices, improving clarity, safety, and tool usage across prompts and configurations.

Core Features & Use Cases

  • Frontmatter validation: ensure required fields exist and are well-formed.
  • Prompt structure analysis: assess clarity, role definition, constraints, and workflows.
  • Tool restrictions & safety: verify allowed tools and guardrails to prevent unsafe execution.
  • Reporting & remediation: generate actionable fixes and guidance for Claude Code, OpenCode, and Codex prompts.

Quick Start

Analyze your agent prompt files to generate a best-practices enhancement report.

Frequently Asked Questions about enhance-agent-prompts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate frontmatter and improve safety in agent prompt files?▼

Agent prompt files are analyzed to validate frontmatter fields, assess prompt structure, and verify tool restrictions. The generated report identifies missing fields and safety guardrail gaps with actionable fixes.

Can I use this to review Claude Code and OpenCode prompts for best practices?▼

Yes, Claude Code, OpenCode, and Codex prompts are fully supported. The analysis checks role definition clarity, workflow constraints, and allowed tool configurations to ensure alignment with prompt-engineering best practices.

What is the best way to check tool restrictions and guardrails in agent prompts?▼

Checking tool restrictions involves analyzing prompt configurations to verify allowed tools and safety guardrails. This process prevents unsafe execution by outputting a structured report detailing detected issues and recommending specific fixes.

How do I analyze agent prompt structure for clarity and role definition?▼

Analyzing agent prompt structure assesses clarity, role definition, constraints, and defined workflows. The analysis identifies structural weaknesses and outputs guidance for normalizing prompts to align with best practices.

Does this prompt enhancement process require any external dependencies or setup?▼

No external dependencies or setup components are required. You provide the agent prompt files, and the tool directly analyzes frontmatter validation, prompt structure, and safety checks to generate a remediation report.

Why does my agent prompt execution fail safety checks and tool restrictions?▼

Safety check failures occur when prompt configurations lack proper tool restrictions and guardrails. Analyzing the prompt file identifies missing safety constraints and outputs recommended fixes to prevent unsafe execution.

Related Skills

Explore More Software Engineering Skills→
v0lkav0lka
15

prompts-review

Audit prompts across a codebase for clarity, safety, and efficiency.

Community
Advanced
jshsakurajshsakura
22

prompt-engineer

Refine prompts to enforce task boundaries, output contracts, and safety constraints.

Community
Advanced
edheltzeledheltzel
134

converting-slash-commands

Convert Claude Code slash commands to OpenCode command format.

Community
Advanced
torlando-techtorlando-tech
3

micron-syntax

Explain Micron markup syntax for NomadNet terminal content rendering.

Community
Basic