agent-review

Review Stencila agent definitions against the Agent schema.

900|58|Updated May 31, 2012
One-click install
npx skills add https://github.com/stencila/stencila --skill agent-review-stencila
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-review
Source: https://github.com/stencila/stencila/tree/main/.stencila/skills/agent-review
Command: npx skills add https://github.com/stencila/stencila --skill agent-review-stencila

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the critical review of Stencila agent configurations, ensuring they are well-defined, secure, and adhere to best practices, thereby improving agent quality and reliability.

Core Features & Use Cases

  • Comprehensive Validation: Checks frontmatter, system instructions, tool usage, and security posture against the Stencila Agent schema.
  • Actionable Feedback: Provides specific, prioritized suggestions for improvement.
  • Use Case: Before deploying a new agent, use this Skill to perform a thorough audit, catching potential issues like overly permissive tool access or vague descriptions, ensuring the agent functions as intended and safely.

Quick Start

Use the agent-review skill to review the agent located at .stencila/agents/code-reviewer.

Frequently Asked Questions about agent-review

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

FAQPage Schema
How do I audit agent configuration for security and schema correctness?

To audit agent configuration, you validate frontmatter, system instructions, tool scope, and security settings against the Stencila Agent schema to ensure correctness, completeness, and safe deployment.

What does an agent configuration review check for?

An agent configuration review checks for overly permissive tool access, vague descriptions, and adherence to the Stencila Agent schema, providing structured reports with prioritized suggestions for improvement.

When should I perform a security validation on my agent definitions?

Perform security validation on agent definitions before deploying a new agent to catch potential issues like overly permissive tool access and ensure the agent functions safely and as intended.

How do I review a Stencila agent located in a specific directory?

To review a Stencila agent, target the agent definition file path, such as .stencila/agents/code-reviewer, to critically evaluate its configuration and generate actionable feedback.

Can I get actionable suggestions for improving incomplete agent definitions?

Yes, reviewing agent definitions provides specific, prioritized, and actionable suggestions to improve incomplete configurations, ensuring they are well-defined and adhere to best practices.