CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

autonomous-agent-patterns

Design patterns for building autonomous coding agents, inspired by [Cline](https://github.com/cline/cline) and [OpenAI Codex](https://github.com/openai/codex).

50

Quality

63%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/autonomous-agent-patterns/SKILL.md

The canonical home for this skill is autonomous-agent-patterns in sickn33/agentic-awesome-skills

SKILL.md
Quality
Evals
Security

Quality

Content

57%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The skill body delivers strong, concrete pattern implementations across agent architecture, tooling, safety, browser automation, and MCP, making it highly actionable. However, it is a monolithic ~750-line file with everything inlined (no progressive disclosure via reference files), contains time-sensitive model identifiers, and lacks explicit validation/feedback loops in its operational workflows. Overall solid, actionable reference material with clear organizational and conciseness improvements available.

Suggestions

Split large topic areas (Browser Automation, MCP Integration, Context Management) into one-level-deep reference files (e.g., references/browser.md, references/mcp.md) and keep SKILL.md as a concise overview with well-signaled links.

Remove or generalize the hard-coded dated model IDs ("gpt-3.5-turbo", "claude-3-sonnet") to avoid time-sensitive staleness penalties, or move them to a clearly labeled legacy/deprecated section.

Add explicit validation/feedback checkpoints to the operational workflows (e.g., after sandboxed command execution or file edits: verify result, fix on failure, re-run) and define the shared ToolResult type and imports so code examples are copy-paste executable.

DimensionReasoningScore

Conciseness

The body is mostly code examples with light commentary and is not padded with explanations of basic concepts, but it includes unnecessary content that could be trimmed: hard-coded, time-sensitive model identifiers ("gpt-3.5-turbo", "gpt-4-turbo", "claude-3-sonnet" — the guideline explicitly penalizes version-specific info outside a deprecated section), a large ASCII-art diagram, and boilerplate implementations (e.g., ReadFileTool) that Claude could already produce. This fits anchor 3 ("mostly efficient but includes some unnecessary explanation or could be tightened") better than 4, where over-explanation would be only minor.

3 / 5

Actionability

The body provides extensive concrete, near-complete Python code for every pattern — agent loop, tool schemas with JSON Schema definitions, edit tool with occurrence validation, permission manager, sandbox validator, browser tools, checkpoint manager — which is close to anchor 4 ("mostly executable guidance; concrete code or commands with minor gaps"). It falls short of 5 because the snippets are not copy-paste runnable: ToolResult and Any are never defined, imports (json, os, shlex, subprocess, base64, requests, playwright) are missing, and llm.chat() is a fictional API — yet these gaps are consistent and minor rather than the pseudocode-level gaps of anchor 3.

4 / 5

Workflow Clarity

The content is organized as a topical catalog (architecture → tools → permissions → browser → context → MCP) rather than a sequenced workflow, and the final "Best Practices Checklist" supplies implicit checkpoints ("Permission system implemented", "Sandbox for untrusted code"). There are no explicit validation/feedback loops in the workflows that execute commands or edit files (e.g., the sandbox example runs shell commands with no verify-and-retry step), which caps this at 3 — matching anchor 3 ("sequence present but checkpoints missing or implicit") and clearly below 4's "clear sequence with most checkpoints present".

3 / 5

Progressive Disclosure

The body has clear structure — six numbered sections with subsections, a best-practices checklist, and a Resources list — but it is a ~750-line monolithic file in which substantial topic areas (browser automation, MCP integration, context management) are fully inlined with no reference files at all (no references/, scripts/, or assets/ exist in the bundle). This matches anchor 3 ("some structure but could be better organized; content that should be separate is inline") rather than 2, since the section structure is genuinely good, not minimal; it cannot reach 4 because content clearly belonging in separate one-level-deep reference files is all inlined in SKILL.md.

3 / 5

Total

13

/

20

Passed

Description

53%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description clearly states what the skill contains and its niche, but omits any "use when" trigger guidance and enumerates no concrete capabilities, leaving users to guess when it applies. Trigger-term coverage is adequate but lacks common synonyms. It is a moderately informative description with clear improvement headroom.

Suggestions

Add an explicit trigger clause, e.g., "Use when building autonomous AI agents, designing tool-calling APIs, or implementing permission/approval systems for agents."

Enumerate 2-3 concrete capabilities in the description (agent loop architecture, permission/sandboxing patterns, browser automation, MCP integration) instead of the abstract phrase "design patterns".

Include natural synonyms users would say, such as "AI agent", "tool calling", "human-in-the-loop", and "MCP", to improve trigger matching and distinctiveness.

DimensionReasoningScore

Specificity

The phrase "Design patterns for building autonomous coding agents" names the domain (autonomous coding agents) and a concrete deliverable (design patterns), which is on par with the anchor-3 example's level of specificity. It falls short of 4 because no specific capabilities are enumerated (e.g., agent loops, permission systems, browser automation, MCP integration are all in the body but absent from the description), and it is above 2 because the domain and content type are clearly and specifically named rather than generic.

3 / 5

Completeness

The "what" is clearly stated ("Design patterns for building autonomous coding agents"), but the "when" is entirely absent — there is no "Use when..." clause or equivalent explicit trigger guidance, which per the judging guidelines caps completeness at 3. This is an exact match for anchor 3 ("Has a clear 'what' but 'when' is missing or only weakly implied"), not 4, which requires both elements present.

3 / 5

Trigger Term Quality

It includes some relevant natural keywords — "autonomous coding agents", "design patterns", plus the recognizable product names "Cline" and "OpenAI Codex" — but misses common variations and synonyms users would naturally say, such as "AI agent", "tool calling", "human-in-the-loop", "agent loop", or "MCP". This matches anchor 3 ("Some relevant keywords but missing common variations or synonyms") and not 4, since several natural trigger phrases are missing.

3 / 5

Distinctiveness Conflict Risk

The niche is fairly distinct — design patterns for building autonomous coding agents, anchored by the named inspirations Cline and OpenAI Codex — creating minor overlap risk only with closely related agent-building skills. It does not reach 5 because the description provides no explicit distinct triggers, relying on the somewhat broad phrase "building autonomous coding agents".

4 / 5

Total

13

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (765 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/autonomous-agent-patterns/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.