cognito
AWS Cognito user authentication and authorization service. Use when setting up user pools, configuring identity pools, implementing OAuth flows, managing user attributes, or integrating with social identity providers.
Install with Tessl CLI
npx tessl i github:itsmostafa/aws-agent-skills --skill cognitoOverall
score
81%
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-crafted skill description that follows best practices. It uses third person voice, provides specific AWS Cognito capabilities, includes an explicit 'Use when...' clause with concrete trigger scenarios, and uses terminology that developers would naturally use when seeking help with Cognito authentication.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'setting up user pools', 'configuring identity pools', 'implementing OAuth flows', 'managing user attributes', 'integrating with social identity providers'. These are distinct, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what ('AWS Cognito user authentication and authorization service') and when ('Use when setting up user pools, configuring identity pools...'). Has explicit 'Use when...' clause with specific trigger scenarios. | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'Cognito', 'user pools', 'identity pools', 'OAuth', 'user attributes', 'social identity providers'. These cover common terminology developers use when working with AWS authentication. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with AWS Cognito-specific terminology (user pools, identity pools, OAuth flows). Unlikely to conflict with generic auth skills due to specific AWS service naming and Cognito-specific concepts. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid, actionable reference for AWS Cognito with excellent executable code examples and comprehensive CLI coverage. The main weaknesses are verbosity in introductory sections, lack of explicit multi-step workflow guidance with validation checkpoints, and a monolithic structure that could benefit from splitting detailed reference content into separate files.
Suggestions
Remove or significantly trim the Core Concepts section - Claude knows what user pools and tokens are; focus on Cognito-specific gotchas instead
Add an explicit numbered workflow for common end-to-end scenarios (e.g., 'Setting up a new user pool from scratch') with validation steps between each operation
Move CLI Reference tables and Troubleshooting sections to separate linked files to improve progressive disclosure
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient with good code examples, but includes some unnecessary explanations Claude already knows (e.g., 'Amazon Cognito provides authentication, authorization, and user management') and the Core Concepts section explains basic concepts that could be trimmed. | 2 / 3 |
Actionability | Excellent executable code examples throughout - complete CLI commands with all flags, working Python code with proper imports, and copy-paste ready snippets for all major operations including secret hash calculation. | 3 / 3 |
Workflow Clarity | Individual operations are clear, but multi-step workflows (like full user registration flow: create pool → create client → sign up → confirm → authenticate) lack explicit sequencing and validation checkpoints between steps. | 2 / 3 |
Progressive Disclosure | Has a table of contents and organized sections, but the document is quite long (~300 lines) with all content inline. CLI reference tables and troubleshooting could be split into separate files with clear navigation links. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
75%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 12 / 16 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata' field is not a dictionary | Warning |
license_field | 'license' field is missing | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
body_steps | No step-by-step structure detected (no ordered list); consider adding a simple workflow | Warning |
Total | 12 / 16 Passed | |
- 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.