shell-scripting

I took a look at your shell-scripting skill and wanted to share some thoughts.

Links:

• GitHub
• Your agentic skill in the SkillzWave marketplace

The TL;DR

You're at 65/100, which puts you in D territory – this one needs some work before it's ready to ship. The grading is based on Anthropic's skill best practices across 5 pillars. Your strongest area is Spec Compliance (12/15) – the frontmatter and metadata are solid. The biggest drag is Progressive Disclosure Architecture (19/30) – you're cramming everything into one 170-line file when it should be layered and modular.

What's Working Well

• Valid metadata: Your YAML frontmatter is clean, triggers like 'shell script', 'bash', and 'zsh' are solid
• Good template: You've included a safe script template with proper error handling patterns – that's useful
• Clear section structure: Headers for core competencies, patterns, and tools make it easy to navigate within the file
• Practical patterns: The examples actually address real scripting needs (argument parsing, error handling, etc.)

The Big One: No Layered Architecture

Here's what's holding you back the most: all content lives in a single SKILL.md file. This violates the Progressive Disclosure Architecture (PDA) principle that Claude skills should use – basically, start users with essentials, then offer references for depth.

Why it matters: A 170-line file is heavier than it needs to be. Users landing on your skill get overloaded, and you lose ~8 points right there.

The fix: Create a references/ directory with separate files:

• references/shell-templates.md – move your template and variations here
• references/common-patterns.md – move best practices (error handling, argument parsing, etc.)
• `references/modern-tool...