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.

1.11x

Quality

82%

Does it follow best practices?

Impact

90%

1.11x

Average score across 3 eval scenarios

Securityby

High

Do not use without reviewing

Quality

Content

72%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.

A highly actionable, well-structured Cognito reference with copy-paste-ready code, but it is a monolithic inline catalog with no progressive disclosure into bundle files and lacks validation feedback loops around its destructive operations.

Suggestions

Add explicit validation checkpoints (e.g., describe-user-pool to confirm settings, verify JWT before trusting claims) around destructive or batch operations like delete-user-pool and admin-delete-user to lift workflow clarity above 3.

Move the large CLI command tables and full code examples into bundle files (e.g., references/cli-reference.md, references/code-samples.md) and reference them from SKILL.md so the main file stays a lean overview.

Trim the Core Concepts explanations of well-known ideas (what user pools and identity pools are) to assume Claude's existing knowledge and improve token efficiency.

Dimension	Reasoning	Score
Conciseness	Mostly efficient reference material (CLI tables, code blocks), but the Core Concepts section briefly restates concepts Claude already knows ('User directory for sign-up and sign-in'), leaving minor trim opportunities.	4 / 5
Actionability	Provides copy-paste-ready boto3 and AWS CLI examples across all common cases (create pool/client, sign up, confirm, auth, refresh, identity pool, credentials), matching the fully-executable anchor.	5 / 5
Workflow Clarity	Content is organized as a task catalog rather than a sequenced workflow, and destructive operations (delete-user-pool, admin-delete-user) appear without validate->fix->retry checkpoints, capping workflow clarity at 3 per the rubric guideline.	3 / 5
Progressive Disclosure	No bundle files exist and ~350 lines of inline CLI reference tables and code blocks remain in SKILL.md; section/TOC structure is good, but reference content that could be split into separate files is all inline, matching the score-3 anchor.	3 / 5
	Total	15 / 20 Passed

Description

92%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.

A strong, well-scoped description that clearly states both what the skill does and when to use it, with concrete Cognito-specific trigger terms. Minor room to add synonyms like SAML or federation for fuller trigger coverage.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'setting up user pools, configuring identity pools, implementing OAuth flows, managing user attributes, or integrating with social identity providers' — covering the service comprehensively, matching the score-5 anchor.	5 / 5
Completeness	Explicitly states the 'what' ('AWS Cognito user authentication and authorization service') and an explicit 'when' with concrete trigger phrases, matching the score-5 anchor.	5 / 5
Trigger Term Quality	Good natural keyword coverage (user pools, identity pools, OAuth flows, social identity providers) that users would say, but misses common synonyms like SAML, federation, or 'sign-in', so it sits just below comprehensive.	4 / 5
Distinctiveness Conflict Risk	Scoped to AWS Cognito with distinct, service-specific triggers, giving it a clear niche with minimal conflict risk against other skills.	5 / 5
	Total	19 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: itsmostafa/aws-agent-skills
Path: skills/cognito/SKILL.md
Commit: e786d25

Reviewed: 2 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.