CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aws-iam-best-practices

IAM policy review, hardening, and least privilege implementation

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/antigravity-aws-iam-best-practices/SKILL.md
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 body is strong on executable, copy-adaptable AWS CLI/Python/JSON examples with unusually good safety boundaries (read-only default, UNKNOWN-not-PASS semantics, secret-handling cautions). Weaknesses are redundancy across three overlapping advice sections, the absence of an explicit ordered review workflow with validation checkpoints for destructive/batch operations, and a monolithic structure that should split large assets into reference files.

Suggestions

Merge "Core Principles", "IAM Hardening Checklist", and "Best Practices" into a single non-redundant checklist, and drop the "Example Prompts" padding.

Lay out an explicit ordered review workflow (scope selection -> identity verification -> credential report -> per-check evidence -> report) with validate-before-proceed checkpoints around destructive steps like key rotation.

Move the full iam-hardening.py script and the policy templates into a references/ directory (e.g., references/scripts/ and references/policies/) and link to them from SKILL.md to reduce the monolithic body.

DimensionReasoningScore

Conciseness

The bulk is dense, useful code and templates, but "Core Principles", the "IAM Hardening Checklist", and "Best Practices" repeat the same well-known advice (least privilege, MFA, managed policies, regular reviews) three times, and "Example Prompts" and "Kiro CLI Integration" add padding. Mostly efficient but should be tightened by merging redundant sections; not 2 because roughly 70% of the body is concrete, non-redundant material.

3 / 5

Actionability

Extensive executable guidance: concrete AWS CLI snippets (list-policies, get-credential-report, simulate-principal-policy), four complete JSON policy templates, and a runnable Python script. Minor gaps remain: the grep-based policy-document matching ('"Action": "\*"') is format-brittle, the bash loops lack error handling, and the body itself notes 'set -euo pipefail' is required only 'in complete scripts', acknowledging the snippets are partial. Not 5 because of these brittleness gaps.

4 / 5

Workflow Clarity

The "Review scope and execution boundaries" section establishes a rough sequence (select scope, verify with 'aws sts get-caller-identity', generate the credential report first, record PASS/FAIL/UNKNOWN per control) and AccessDenied/error cases are defined as UNKNOWN. However, batch loops over all users/policies and destructive key rotation (delete/update-access-key) lack explicit validate-before-proceed checkpoints and feedback loops, so per the judging guidelines workflow clarity is capped at 3. Not 4 because the overall review process is never laid out as an ordered workflow with checkpoints.

3 / 5

Progressive Disclosure

Section headers are clear and "Additional Resources" links to external docs, but this is a 410-line monolithic SKILL.md with no bundle files: a full 80-line Python script, four policy templates, and multiple checklists are inlined where separate reference files would belong. Fits 'some structure but... content that should be separate is inline'; not 2 because structure and navigation are present, not minimal.

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 is concise and names a clear niche, but it omits any 'when to use' trigger clause and lacks keyword breadth (no "AWS", "permissions", or "MFA"). It reads as a terse capability label rather than a complete discovery description.

Suggestions

Add an explicit trigger clause, e.g., "Use when reviewing or hardening AWS IAM policies, permissions, or access keys, or when the user mentions IAM, least privilege, or MFA."

Include 'AWS' and common synonyms like 'permissions' and 'access control' so users searching with natural phrasing can find the skill.

Broaden the action list slightly (e.g., mention MFA enforcement or access key rotation) to make capabilities more concrete.

DimensionReasoningScore

Specificity

"IAM policy review, hardening, and least privilege implementation" names the domain and 2-3 actions, but the actions are generic verbs with no broader concrete coverage (e.g., no mention of MFA, access keys, roles, or specific checks). It matches the 'names domain and 1-2 concrete actions, but not comprehensive' anchor; it is not 4 because the actions lack breadth and specificity, and not 2 because concrete actions in a named domain are present.

3 / 5

Completeness

The description clearly states what the skill does ("IAM policy review, hardening, and least privilege implementation") but contains no 'Use when...' clause or equivalent explicit trigger guidance. Per the judging guidelines, a missing 'when' clause caps completeness at 3; it is not 4 because the 'when' is entirely absent rather than just imprecise.

3 / 5

Trigger Term Quality

"IAM", "policy", "least privilege" are natural terms an AWS user would say, but common variations and synonyms are missing: "AWS" itself never appears, nor "permissions", "access control", or "MFA". This fits 'some relevant keywords but missing common variations or synonyms'; better than 2 (more than a couple of generic keywords) but short of 4's good coverage.

3 / 5

Distinctiveness Conflict Risk

IAM policy review/hardening is a fairly distinct niche with minor overlap risk against generic security-hardening or other cloud identity skills. It is not 5 because the description never states "AWS" and provides no distinct trigger phrasing to fully separate it from neighboring access-control skills, and not 3 because the IAM/least-privilege focus is clearly more specific than a generic overlap case.

4 / 5

Total

13

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

boisenoise/skills-collections

Path

skills/antigravity-aws-iam-best-practices/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.