CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

troubleshooting-efs

Diagnoses and resolves Amazon EFS issues including mount failures, NFS timeouts, permission errors, throughput problems, and burst credit exhaustion. Use when the user has an EFS file system that is not mounting, returning errors, performing slowly, or showing access denied.

Quality

83%

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

The canonical home for this skill is troubleshooting-efs in aws/agent-toolkit-for-aws

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 tight, command-driven troubleshooting runbook with an effective symptom-classification entry point and safety-minded verification steps. The main gaps are the thin, command-less Category E (KMS) section, missing re-validation after applying fixes, and a small amount of duplicated IAM guidance.

Suggestions

Add executable commands to Category E (Encryption/KMS), e.g., `aws kms describe-key --key-id <key-id>` and how to inspect the EFS service-linked role's key policy, matching the concreteness of the other categories.

Close the feedback loop after fixes: re-run `nc -zv fs-ID.efs.REGION.amazonaws.com 2049` after authorizing security group ingress, and re-check VPC DNS attributes after `modify-vpc-attribute`, before declaring the issue resolved.

De-duplicate the IAM enforcement note (stated in both Category C and Security Considerations) and fix the Category B numbered list, which restarts at '1.' twice, to keep the sequence unambiguous.

DimensionReasoningScore

Conciseness

The body is dense and operational — a symptom-to-category table, copy-paste CLI commands, and no explanation of concepts Claude already knows. Minor trimming is possible: the IAM enforcement caveat ("IAM authorization is only enforced when a file system policy exists...") appears nearly verbatim in both Category C and Security Considerations.

4 / 5

Actionability

Most sections give executable, copy-paste AWS CLI commands with explicit expected outcomes (e.g., "nc -zv fs-ID.efs.REGION.amazonaws.com 2049", the CloudWatch BurstCreditBalance query). It falls short of anchor 5 because Category E offers only console-level directions ("Verify key is enabled in KMS console", "Verify EFS service-linked role has KMS permissions") with no commands, and the POSIX section is thin.

4 / 5

Workflow Clarity

A clear diagnostic pipeline exists: dependency verification, symptom-to-category classification table, then per-category steps with embedded checkpoints (connectivity test with nc, "Both MUST be true" for DNS attributes, PercentIOLimit threshold guidance) and confirmation gates for mutating commands. It is not anchor 5 because there is no re-validation after applying fixes (e.g., re-run nc after authorizing ingress) and the Category B numbered list mis-sequences (two consecutive '1.' items).

4 / 5

Progressive Disclosure

No bundle files exist, and the ~170-line runbook is well-sectioned (Overview, Common Tasks by category, Troubleshooting, Security Considerations, Additional Resources) with deep material delegated to official AWS doc links. Minor gaps keep it from anchor 5: the category deep-dives could live in per-category reference files, and the Additional Resources links duplicate the Overview link.

4 / 5

Total

16

/

20

Passed

Description

87%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 description in third-person voice that pairs a comprehensive enumeration of EFS problem classes with an explicit, symptom-based 'Use when' trigger clause. Its only weakness is that the stated actions are two generic verbs (diagnose, resolve) rather than several distinct concrete capabilities.

DimensionReasoningScore

Specificity

"Diagnoses and resolves Amazon EFS issues including mount failures, NFS timeouts, permission errors, throughput problems, and burst credit exhaustion" comprehensively enumerates concrete problem classes, but the actions themselves are limited to two generic verbs ("Diagnoses and resolves"), so it falls just below the anchor-5 requirement of multiple specific concrete actions.

4 / 5

Completeness

It clearly answers "what" ("Diagnoses and resolves Amazon EFS issues including mount failures, NFS timeouts, permission errors, throughput problems, and burst credit exhaustion") and "when" with concrete trigger phrases ("not mounting, returning errors, performing slowly, or showing access denied"), matching the anchor-5 example structure. It is not score 4 because the 'when' clause is explicit and enumerates specific symptoms rather than being merely serviceable.

5 / 5

Trigger Term Quality

"Use when the user has an EFS file system that is not mounting, returning errors, performing slowly, or showing access denied" covers natural phrasings users would say, plus keywords like "NFS timeouts" and "burst credit exhaustion". A few common variations (e.g., "EFS mount fails", "can't mount EFS", "efs-utils") are missing, keeping it below comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is clearly staked out as "Amazon EFS" with symptom-specific triggers (mount failures, burst credit exhaustion), which a generic NFS, Linux mount, or storage skill would not claim. Minor overlap with general NFS troubleshooting exists but triggers are EFS-anchored, matching the anchor-5 'clear niche with distinct triggers'.

5 / 5

Total

18

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository

mreferre/aws-agent-toolkit-skills

Path

.kiro/skills/troubleshooting-efs/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.