agentic-workflow

Practical AI agent workflows and productivity techniques. Provides optimized patterns for daily development tasks such as commands, shortcuts, Git integration, MCP usage, and session management.

1.33x

Quality

52%

Does it follow best practices?

Impact

95%

1.33x

Average score across 3 eval scenarios

Securityby

Critical

Do not install without reviewing

Optimize this skill with Tessl

npx tessl skill review --optimize ./.agent-skills/agentic-workflow/SKILL.md

Quality

Discovery

25%

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 attempts to cover a broad productivity domain but lacks the specificity and explicit trigger guidance needed for reliable skill selection. It reads more like a category overview than a targeted skill description, and the wide scope creates high conflict risk with other development-related skills.

Suggestions

Add an explicit 'Use when...' clause with natural trigger phrases like 'Use when the user asks about Claude workflows, agent productivity tips, or how to work more efficiently with AI assistants'

Narrow the scope or split into distinct skills - currently covers Git, MCP, shortcuts, and session management which could each be separate skills with clearer triggers

Replace category names with concrete actions, e.g., 'Explains how to chain commands, set up keyboard shortcuts for common prompts, manage conversation context across sessions'

Dimension	Reasoning	Score
Specificity	Names the domain (AI agent workflows, productivity) and lists some actions (commands, shortcuts, Git integration, MCP usage, session management), but these are categories rather than concrete specific actions like 'generate commit messages' or 'create shortcuts'.	2 / 3
Completeness	Describes what it does (provides patterns for development tasks) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill.	1 / 3
Trigger Term Quality	Includes some relevant terms like 'Git integration', 'MCP', 'session management', 'shortcuts', but missing natural user phrases like 'how do I use Claude', 'agent tips', 'workflow help', or 'productivity hacks'. 'MCP' is technical jargon that users may not naturally say.	2 / 3
Distinctiveness Conflict Risk	Very broad scope covering 'AI agent workflows', 'productivity techniques', and 'daily development tasks' could easily conflict with Git-specific skills, general coding skills, or other productivity tools. No clear niche defined.	1 / 3
	Total	6 / 12 Passed

Implementation

79%

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

This is a well-structured, highly actionable reference skill that efficiently covers multiple AI agent workflows. Its main strengths are concise tabular formats and executable code examples. The weaknesses are the lack of explicit validation/error-recovery steps in multi-step workflows and the monolithic structure that could benefit from splitting detailed topics into separate files.

Suggestions

Add explicit validation checkpoints to multi-step workflows (e.g., 'If PR checkout fails, check authentication with gh auth status')

Include error recovery guidance in the TDD and multi-agent workflow sections (what to do when tests fail, when MCP servers don't respond)

Consider splitting detailed MCP server usage and multi-agent patterns into separate reference files linked from this overview

Dimension	Reasoning	Score
Conciseness	The content is lean and efficient, using tables and code blocks to convey information densely. No unnecessary explanations of concepts Claude already knows; every section provides actionable reference material.	3 / 3
Actionability	Provides concrete, copy-paste ready commands, shortcuts, and code examples throughout. The Git workflow, Docker setup, and session management sections all contain executable commands and specific examples.	3 / 3
Workflow Clarity	Multi-step workflows like PR review and TDD are listed but lack explicit validation checkpoints. The multi-agent orchestration pattern shows sequence but doesn't include error recovery or feedback loops for when steps fail.	2 / 3
Progressive Disclosure	Content is well-organized with clear sections and a quick reference card, but it's a monolithic document. Complex topics like MCP servers and multi-agent workflows could benefit from separate detailed files with links from this overview.	2 / 3
	Total	10 / 12 Passed

Validation

100%

Warnings & errors only

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

Validation — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository: supercent-io/skills-template
Commit: fd18296

Reviewed: 26 days ago

Table of Contents

Discovery Implementation Validation

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.