unxed/f4 / .agents/skills/aif-skill-generator
aif-skill-generator
FlaggedGenerate professional Agent Skills for AI agents. Creates complete skill packages with SKILL.md, references, scripts, and templates. Use when creating new skills, generating custom slash commands, or building reusable AI capabilities. Validates against Agent Skills specification.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 23.6 KB |
| references/BEST-PRACTICES.md | markdown | 5.3 KB |
| references/EXAMPLES.md | markdown | 5.0 KB |
| references/LEARN-MODE.md | markdown | 7.1 KB |
| references/SECURITY-SCANNING.md | markdown | 4.6 KB |
| references/SPECIFICATION.md | markdown | 3.0 KB |
| scripts/cleanup-blocked-skill.pyexecutable | script | 23.4 KB |
| scripts/search-skills.pyexecutable | script | 2.9 KB |
| scripts/security-scan.pyexecutable | script | 27.9 KB |
| scripts/validate.shexecutable | script | 5.5 KB |
| templates/basic.md | markdown | 511 B |
| templates/dynamic-context.md | markdown | 1.4 KB |
| templates/research.md | markdown | 956 B |
| templates/task.md | markdown | 807 B |
| templates/visual.md | markdown | 1.9 KB |
scripts/validate.sh
View on GitHub#!/bin/bash
# Skill Validator
# Usage: ./validate.sh <path-to-skill>
set -e
SKILL_PATH="${1:-.}"
SKILL_MD="$SKILL_PATH/SKILL.md"
echo "=== Skill Validator ==="
echo "Validating: $SKILL_PATH"
echo ""
# Colors
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m' # No Color
ERRORS=0
WARNINGS=0
error() {
echo -e "${RED}ERROR:${NC} $1"
ERRORS=$((ERRORS + 1))
}
warn() {
echo -e "${YELLOW}WARNING:${NC} $1"
WARNINGS=$((WARNINGS + 1))
}
pass() {
echo -e "${GREEN}PASS:${NC} $1"
}
# Check SKILL.md exists
if [[ ! -f "$SKILL_MD" ]]; then
error "SKILL.md not found at $SKILL_MD"
exit 1
fi
pass "SKILL.md exists"
# Extract frontmatter (between first two --- lines)
FRONTMATTER=$(tr -d '\r' < "$SKILL_MD" | awk '/^---$/{if(++n==1)next; if(n==2)exit} n==1')
if [[ -z "$FRONTMATTER" ]]; then
error "No YAML frontmatter found (must be between --- markers)"
exit 1
fi
pass "Frontmatter found"
# Check frontmatter size (~tokens approximated by word count)
FM_WORDS=$(echo "$FRONTMATTER" | wc -w | tr -d ' ')
if [[ $FM_WORDS -gt 100 ]]; then
error "Frontmatter exceeds 100 tokens (~words): $FM_WORDS"
else
pass "Frontmatter size OK ($FM_WORDS tokens)"
fi
# Check name field - get only the value on the same line
NAME=$(echo "$FRONTMATTER" | grep -E "^name:" | head -1 | sed 's/^name:[[:space:]]*//' | tr -d '"' | tr -d "'" | tr -d ' ')
if [[ -z "$NAME" ]]; then
error "Missing required 'name' field"
else
# Validate name format
if [[ ${#NAME} -gt 64 ]]; then
error "Name exceeds 64 characters: ${#NAME} ('$NAME')"
fi
if [[ ! "$NAME" =~ ^[a-z0-9]([a-z0-9-]*[a-z0-9])?$ ]] && [[ ! "$NAME" =~ ^[a-z0-9]$ ]]; then
error "Invalid name format. Must be lowercase, hyphens only, no consecutive hyphens, no dots: '$NAME'"
fi
if [[ "$NAME" =~ -- ]]; then
error "Name contains consecutive hyphens"
fi
# Check name matches directory
DIR_NAME=$(basename "$(cd "$SKILL_PATH" && pwd)")
if [[ "$NAME" != "$DIR_NAME" ]]; then
error "Name '$NAME' doesn't match directory name '$DIR_NAME'"
else
pass "Name '$NAME' matches directory"
fi
fi
# Check description field - handle multiline (read directly from file to avoid quoting issues)
DESC=$(tr -d '\r' < "$SKILL_MD" | awk '
/^---$/ { n++; next }
n == 1 && /^description:/ {
found = 1
sub(/^description:[[:space:]]*/, "")
if ($0 ~ /^[>|]/) next
if ($0 != "") desc = desc $0 " "
next
}
n == 1 && found && /^[[:space:]]/ {
gsub(/^[[:space:]]+/, "")
desc = desc $0 " "
next
}
n == 1 && found && /^[^[:space:]]/ { exit }
n == 2 { exit }
END { print desc }
' )
if [[ -z "$DESC" ]]; then
error "Missing required 'description' field"
else
DESC_LEN=${#DESC}
if [[ $DESC_LEN -gt 1024 ]]; then
error "Description exceeds 1024 characters: $DESC_LEN"
elif [[ $DESC_LEN -lt 20 ]]; then
warn "Description seems too short ($DESC_LEN chars). Consider adding more detail."
else
pass "Description present ($DESC_LEN chars)"
fi
# Check for "when to use" keywords
if ! echo "$DESC" | grep -qi "use when\|when \|use for\|for "; then
warn "Description may not explain when to use the skill"
fi
fi
# Check argument-hint quoting (unquoted [] breaks YAML in OpenCode/Kilo Code, crashes agent TUI)
ARG_HINT_LINE=$(echo "$FRONTMATTER" | grep -E "^argument-hint:" | head -1)
if [[ -n "$ARG_HINT_LINE" ]]; then
ARG_HINT_VALUE=$(echo "$ARG_HINT_LINE" | sed 's/^argument-hint:[[:space:]]*//')
if [[ "$ARG_HINT_VALUE" =~ ^\[.*\] ]]; then
# Starts with [ — unquoted YAML array syntax
error "argument-hint contains unquoted brackets: $ARG_HINT_VALUE"
echo " Fix: wrap in quotes → argument-hint: \"$ARG_HINT_VALUE\""
elif [[ "$ARG_HINT_VALUE" =~ ^\".*\"$ ]] || [[ "$ARG_HINT_VALUE" =~ ^\'.*\'$ ]]; then
pass "argument-hint is properly quoted"
else
pass "argument-hint OK"
fi
fi
# Count body lines (after second ---)
BODY_LINES=$(tr -d '\r' < "$SKILL_MD" | awk '/^---$/{if(++n==2){found=1; next}} found' | wc -l | tr -d ' ')
if [[ $BODY_LINES -gt 500 ]]; then
warn "SKILL.md body exceeds 500 lines ($BODY_LINES). Consider moving content to references/"
else
pass "Body line count OK ($BODY_LINES lines)"
fi
# Check optional directories
if [[ -d "$SKILL_PATH/scripts" ]]; then
pass "scripts/ directory found"
# Check scripts are executable
for script in "$SKILL_PATH/scripts"/*; do
if [[ -f "$script" && ! -x "$script" ]]; then
warn "Script not executable: $(basename "$script")"
fi
done
fi
if [[ -d "$SKILL_PATH/references" ]]; then
pass "references/ directory found"
fi
if [[ -d "$SKILL_PATH/templates" ]]; then
pass "templates/ directory found"
fi
if [[ -d "$SKILL_PATH/assets" ]]; then
pass "assets/ directory found"
fi
# Check for common issues
if grep -q "TODO\|FIXME\|XXX" "$SKILL_MD" 2>/dev/null; then
warn "SKILL.md contains TODO/FIXME markers"
fi
# Check for unfilled template placeholders (but not in code blocks)
if grep -v '```' "$SKILL_MD" | grep -q "{{[A-Z_]*}}" 2>/dev/null; then
warn "SKILL.md contains template placeholders ({{...}})"
fi
echo ""
echo "=== Summary ==="
echo -e "Errors: ${RED}$ERRORS${NC}"
echo -e "Warnings: ${YELLOW}$WARNINGS${NC}"
if [[ $ERRORS -gt 0 ]]; then
echo -e "\n${RED}Validation FAILED${NC}"
exit 1
else
echo -e "\n${GREEN}Validation PASSED${NC}"
exit 0
fi
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |