CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aws-iam

Provides verified corrections for IAM behaviors that AI agents frequently get wrong — policy evaluation edge cases, trust policy gotchas, STS session limits, Organizations quirks, and SAML/MFA specifics. Also provides structured workflows for IAM role management and baseline policy generation from application source code or a Terraform plan JSON. Covers condition operator safety (ForAnyValue/ForAllValues with Null checks), bucket policy deny patterns (VPC endpoint restrictions, org paths), confused deputy protection, and service role creation for AWS services (Glue, CloudTrail, Lambda, ECS, etc.) with aws:SourceAccount/aws:SourceArn trust conditions. Applies when creating IAM roles, writing IAM or bucket policies, generating policies from application source code or a Terraform plan JSON, working with STS, Organizations, or condition operators, or any task needing a service or execution role. Does not cover non-IAM authorization like Cognito user-pool policies or app-level RBAC.

Quality

90%

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

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 lean, highly actionable correction catalog with excellent progressive-disclosure routing for its two main references. Weak points are minor: a redundant 'About This Skill' paragraph, a buried inline reference to common-pitfalls.md, and one second-level reference chain.

Suggestions

Trim the 'About This Skill' paragraph to a single sentence ('Verify specific claims against official AWS documentation; trust documentation over memory') — it currently makes the same point three ways.

Add common-pitfalls.md to the 'Common Workflows' routing list (e.g., 'Read if the task involves condition operators, tag keys, or policy evaluation edge cases') instead of only linking it mid-catalog, and surface service-authorization.md directly so it is not two levels deep.

Consider a brief verify step in the workflows (e.g., 'After generating a policy, validate actions against the service authorization reference') to add an explicit checkpoint to the routing flow.

DimensionReasoningScore

Conciseness

The body is a dense catalog of exact corrections ('methods are activate(), deactivate(), delete() — NO update()', 'DuplicatePolicyAttachmentException (not PolicyAlreadyAttachedException)') with a single purposeful JSON example. The 'About This Skill' paragraph repeats its documentation-verification advice three ways ('verify specific claims ... against official AWS documentation', 'Prefer fetching known documentation URLs', 'Trust official documentation over memory'), which is minor over-explanation to trim — fits 4 rather than 5.

4 / 5

Actionability

Gives exact method names, exception names, the SAML ACS URL format, a copy-paste-ready JSON policy for the ForAllValues/Null pattern, an exact CLI command ('aws organizations list-available-policy-types'), and a named list of the 8 privilege-escalation actions. For a correction/routing skill this is fully concrete guidance covering the common cases — a 5, not 4 with 'minor gaps'.

5 / 5

Workflow Clarity

The 'Common Workflows' section gives unambiguous conditional routing ('Read references/aws-iam-role-management.md if the user needs to create, scope, or maintain IAM roles...' plus the CRITICAL iam-policy-autopilot mandate). However common-pitfalls.md routing is only linked inline mid-catalog, and there are no verification checkpoints — clear but with minor gaps, matching 4 rather than 5's explicit validation/feedback loops.

4 / 5

Progressive Disclosure

All referenced paths resolve to real bundle files, and two references are clearly signaled with 'Read X if Y' conditions. But service-authorization.md is only reachable two levels deep (via aws-iam-policy-generation.md), and common-pitfalls.md is buried mid-section rather than listed in Common Workflows — good structure with minor organization gaps, so 4 rather than 5's fully one-level-deep, well-signaled references.

4 / 5

Total

17

/

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 dense, third-person description that clearly states what it corrects and exactly when it applies, with explicit non-goals that reduce conflict risk. The only gap is that a few covered domains (SAML, MFA, CloudTrail specifics) lack corresponding trigger phrases in the 'when' clause.

DimensionReasoningScore

Specificity

Lists many concrete capabilities — 'policy evaluation edge cases, trust policy gotchas, STS session limits', 'service role creation ... with aws:SourceAccount/aws:SourceArn trust conditions', 'baseline policy generation from application source code or a Terraform plan JSON' — all in third-person voice with no vague filler. Coverage is comprehensive rather than having minor gaps, so it fits the 5 anchor rather than 4.

5 / 5

Completeness

Explicitly answers what ('Provides verified corrections... structured workflows for IAM role management and baseline policy generation') and when ('Applies when creating IAM roles, writing IAM or bucket policies...'), plus explicit exclusions ('Does not cover non-IAM authorization like Cognito user-pool policies or app-level RBAC'). Both halves with concrete trigger phrases — a clear 5, not 4 where 'when' could be more specific.

5 / 5

Trigger Term Quality

'Applies when creating IAM roles, writing IAM or bucket policies, generating policies from application source code or a Terraform plan JSON, working with STS, Organizations, or condition operators, or any task needing a service or execution role' gives strong natural terms with synonyms (service/execution role). However SAML, MFA, and CloudTrail tasks described in the 'what' have no corresponding trigger phrases, keeping it at 4 ('a few natural terms missing') rather than 5.

4 / 5

Distinctiveness Conflict Risk

A clear AWS IAM niche with distinct triggers (IAM roles, bucket policies, STS, condition operators, service/execution roles) and explicit boundary exclusions, so it is unlikely to fire for a wrong skill. Minimal conflict risk matches the 5 anchor; it is not merely 'mostly distinct' as in the 4 anchor.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

aws/agent-toolkit-for-aws

Path

skills/core-skills/aws-iam/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.