Skip to content

netresearch/agent-rules-skill / skills/agent-rules

agent-rules

Flagged

Use when creating or updating AGENTS.md files, .github/copilot-instructions.md, or other AI agent rule files, onboarding AI agents to a project, standardizing agent documentation, or when anyone mentions AGENTS.md, agent rules, project onboarding, or codebase documentation for AI agents.

FileKindSize
AGENTS.mdmarkdown4.0 KB
CLAUDE.mdmarkdown9 B
SKILL.mdskill md5.2 KB
assets/.markdownlint-cli2.jsoncother624 B
assets/example-workflows/validate-agents.ymlconfig2.8 KB
assets/root-thin.mdmarkdown5.7 KB
assets/root-verbose.mdmarkdown5.5 KB
assets/scoped/backend-go.mdmarkdown3.6 KB
assets/scoped/backend-php.mdmarkdown3.0 KB
assets/scoped/backend-python.mdmarkdown2.6 KB
assets/scoped/backend-typescript.mdmarkdown2.8 KB
assets/scoped/claude-code-skill.mdmarkdown3.4 KB
assets/scoped/cli.mdmarkdown2.7 KB
assets/scoped/concourse.mdmarkdown5.2 KB
assets/scoped/ddev.mdmarkdown2.4 KB
assets/scoped/docker.mdmarkdown5.3 KB
assets/scoped/documentation.mdmarkdown3.5 KB
assets/scoped/examples.mdmarkdown3.4 KB
assets/scoped/frontend-typescript.mdmarkdown2.7 KB
assets/scoped/github-actions.mdmarkdown5.2 KB
assets/scoped/gitlab-ci.mdmarkdown4.6 KB
assets/scoped/oro-bundle.mdmarkdown6.5 KB
assets/scoped/oro-project.mdmarkdown5.5 KB
assets/scoped/python-modern.mdmarkdown6.1 KB
assets/scoped/resources.mdmarkdown3.5 KB
assets/scoped/skill-repo.mdmarkdown5.4 KB
assets/scoped/symfony.mdmarkdown5.3 KB
assets/scoped/testing.mdmarkdown3.0 KB
assets/scoped/typo3-docs.mdmarkdown3.6 KB
assets/scoped/typo3-extension.mdmarkdown5.1 KB
assets/scoped/typo3-project.mdmarkdown4.7 KB
assets/scoped/typo3-testing.mdmarkdown3.0 KB
checkpoints.yamlconfig14.4 KB
evals/evals.jsonconfig22.9 KB
references/ai-contribution-guidelines.mdmarkdown2.6 KB
references/ai-tool-compatibility.mdmarkdown8.0 KB
references/directory-coverage.mdmarkdown2.5 KB
references/examples/coding-agent-cli/AGENTS.mdmarkdown2.5 KB
references/examples/coding-agent-cli/go.modmanifest45 B
references/examples/coding-agent-cli/scripts-AGENTS.mdmarkdown10.1 KB
references/examples/express-api-ts/.env.exampleother232 B
references/examples/express-api-ts/AGENTS.mdmarkdown3.1 KB
references/examples/express-api-ts/package.jsonmanifest757 B
references/examples/express-api-ts/pnpm-lock.yamlmanifest101 B
references/examples/express-api-ts/src/AGENTS.mdmarkdown3.1 KB
references/examples/express-api-ts/src/config.tsscript917 B
references/examples/express-api-ts/src/controllers/userController.tsscript2.1 KB
references/examples/express-api-ts/src/index.tsscript671 B
references/examples/express-api-ts/src/middleware/errorHandler.tsscript1.0 KB
references/examples/express-api-ts/src/middleware/requestLogger.tsscript471 B
references/examples/express-api-ts/src/routes/health.tsscript428 B
references/examples/express-api-ts/src/routes/users.tsscript397 B
references/examples/express-api-ts/src/utils/errors.tsscript1.2 KB
references/examples/express-api-ts/src/utils/logger.tsscript441 B
references/examples/express-api-ts/tsconfig.jsonconfig630 B
references/examples/fastapi-app/.env.exampleother348 B
references/examples/fastapi-app/AGENTS.mdmarkdown3.2 KB
references/examples/fastapi-app/pyproject.tomlmanifest1.8 KB
references/examples/fastapi-app/src/AGENTS.mdmarkdown2.9 KB
references/examples/fastapi-app/src/__init__.pyscript58 B
references/examples/fastapi-app/src/config.pyscript1.1 KB
references/examples/fastapi-app/src/main.pyscript1.7 KB
references/examples/fastapi-app/src/models/__init__.pyscript278 B
references/examples/fastapi-app/src/models/item.pyscript1.0 KB
references/examples/fastapi-app/src/models/user.pyscript922 B
references/examples/fastapi-app/src/routes/__init__.pyscript110 B
references/examples/fastapi-app/src/routes/health.pyscript470 B
references/examples/fastapi-app/src/routes/items.pyscript1.9 KB
references/examples/fastapi-app/src/routes/users.pyscript1.7 KB
references/examples/fastapi-app/src/services/__init__.pyscript174 B
references/examples/fastapi-app/src/services/item_service.pyscript2.5 KB
references/examples/fastapi-app/src/services/user_service.pyscript2.1 KB
references/examples/fastapi-app/uv.lockmanifest136 B
references/examples/go-api-with-react-admin/.scopesother93 B
references/examples/go-api-with-react-admin/AGENTS.mdmarkdown3.0 KB
references/examples/go-api-with-react-admin/admin/package.jsonmanifest423 B
references/examples/go-api-with-react-admin/admin/src/App.tsxother101 B
references/examples/go-api-with-react-admin/cmd/api/main.goscript75 B
references/examples/go-api-with-react-admin/go.modmanifest31 B
references/examples/go-api-with-react-admin/main.goscript71 B
references/examples/go-with-internal-web-tsx/.scopesother102 B
references/examples/go-with-internal-web-tsx/AGENTS.mdmarkdown3.1 KB
references/examples/go-with-internal-web-tsx/go.modmanifest34 B
references/examples/go-with-internal-web-tsx/internal/web/AGENTS.mdmarkdown3.1 KB
references/examples/go-with-internal-web-tsx/internal/web/package.jsonmanifest329 B
references/examples/go-with-internal-web-tsx/internal/web/src/App.tsxother57 B
references/examples/go-with-internal-web-tsx/internal/web/src/Button.tsxother63 B
references/examples/go-with-internal-web-tsx/internal/web/src/Footer.tsxother63 B
references/examples/go-with-internal-web-tsx/internal/web/src/Header.tsxother63 B
references/examples/go-with-internal-web-tsx/internal/web/src/Sidebar.tsxother65 B
references/examples/go-with-internal-web-tsx/main.goscript85 B
references/examples/go-with-internal-web-tsx/package-lock.jsonmanifest87 B
references/examples/go-with-internal-web-tsx/package.jsonmanifest221 B
references/examples/ldap-selfservice/AGENTS.mdmarkdown2.5 KB
references/examples/ldap-selfservice/go.modmanifest45 B
references/examples/ldap-selfservice/internal-AGENTS.mdmarkdown10.0 KB
references/examples/ldap-selfservice/internal-web-AGENTS.mdmarkdown12.1 KB
references/examples/php-with-frontend/.scopesother89 B
references/examples/php-with-frontend/AGENTS.mdmarkdown3.1 KB
references/examples/php-with-frontend/composer.jsonconfig185 B
references/examples/php-with-frontend/package.jsonmanifest307 B
references/examples/php-with-frontend/pnpm-lock.yamlmanifest101 B
references/examples/php-with-frontend/src/Controller.phpscript41 B
references/examples/php-with-frontend/web/AGENTS.mdmarkdown3.1 KB
references/examples/php-with-frontend/web/package.jsonmanifest515 B
references/examples/php-with-frontend/web/src/App.tsxother63 B
references/examples/php-with-frontend/web/src/Button.tsxother215 B
references/examples/php-with-frontend/web/src/Footer.tsxother125 B
references/examples/php-with-frontend/web/src/Header.tsxother122 B
references/examples/php-with-frontend/web/src/main.tsxother41 B
references/examples/php-with-frontend/web/tsconfig.jsonconfig280 B
references/examples/pnpm-workspace/AGENTS.mdmarkdown2.6 KB
references/examples/pnpm-workspace/package.jsonmanifest105 B
references/examples/pnpm-workspace/packages/web/package.jsonmanifest187 B
references/examples/pnpm-workspace/packages/web/src/index.tsxother258 B
references/examples/pnpm-workspace/pnpm-lock.yamlmanifest920 B
references/examples/pnpm-workspace/pnpm-workspace.yamlconfig27 B
references/examples/simple-ldap-go/AGENTS.mdmarkdown2.5 KB
references/examples/simple-ldap-go/examples-AGENTS.mdmarkdown1.8 KB
references/examples/simple-ldap-go/go.modmanifest43 B
references/examples/t3x-rte-ckeditor-image/AGENTS.mdmarkdown2.5 KB
references/examples/t3x-rte-ckeditor-image/Classes-AGENTS.mdmarkdown12.0 KB
references/examples/t3x-rte-ckeditor-image/composer.jsonconfig174 B
references/feedback-memory-schema.mdmarkdown6.2 KB
references/fleet-sync-sweep.mdmarkdown4.8 KB
references/git-hooks-setup.mdmarkdown2.5 KB
references/output-structure.mdmarkdown5.4 KB
references/quality-rubric.mdmarkdown6.2 KB
references/scripts-guide.mdmarkdown7.7 KB
references/verification-guide.mdmarkdown9.4 KB
scripts/analyze-git-history.shexecutablescript10.2 KB
scripts/check-freshness.shexecutablescript8.9 KB
scripts/detect-golden-samples.shexecutablescript5.7 KB
scripts/detect-heuristics.shexecutablescript3.2 KB
scripts/detect-project.shexecutablescript19.6 KB
scripts/detect-scopes.shexecutablescript13.4 KB
scripts/detect-utilities.shexecutablescript4.6 KB
scripts/extract-adrs.shexecutablescript6.8 KB
scripts/extract-agent-configs.shexecutablescript9.3 KB
scripts/extract-architecture-rules.shexecutablescript19.9 KB
scripts/extract-ci-commands.shexecutablescript12.5 KB
scripts/extract-ci-rules.shexecutablescript16.1 KB
scripts/extract-commands.shexecutablescript11.9 KB
scripts/extract-documentation.shexecutablescript7.8 KB
scripts/extract-github-rulesets.shexecutablescript3.8 KB
scripts/extract-github-settings.shexecutablescript3.6 KB
scripts/extract-ide-settings.shexecutablescript7.0 KB
scripts/extract-platform-files.shexecutablescript8.0 KB
scripts/extract-quality-configs.shexecutablescript14.9 KB
scripts/generate-agents.shexecutablescript118.2 KB
scripts/generate-file-map.shexecutablescript4.6 KB
scripts/lib/config-root.shexecutablescript5.8 KB
scripts/lib/git.shscript1.2 KB
scripts/lib/summary.shscript11.7 KB
scripts/lib/template.shexecutablescript15.9 KB
scripts/score-agents.shexecutablescript9.8 KB
scripts/tests/test-agents-file-write-boundary.shscript5.8 KB
scripts/tests/test-agents-scan-dependency-trees.shexecutablescript4.5 KB
scripts/tests/test-changelog-rule.shexecutablescript3.4 KB
scripts/tests/test-claude-import-file.shscript3.3 KB
scripts/tests/test-command-allowlist.shexecutablescript4.7 KB
scripts/tests/test-dependency-tree-exclusion.shscript2.5 KB
scripts/tests/test-extract-commands-real-scripts.shexecutablescript4.0 KB
scripts/tests/test-git-history-counts.shexecutablescript3.6 KB
scripts/tests/test-golden-sample-file-names.shexecutablescript2.2 KB
scripts/tests/test-json-manifest.shexecutablescript5.5 KB
scripts/tests/test-last-verified-opt-in.shscript1.6 KB
scripts/tests/test-make-target-lookup.shscript2.5 KB
scripts/tests/test-merge-heuristic.shscript1.8 KB
scripts/tests/test-scope-index-heading.shexecutablescript4.4 KB
scripts/tests/test-scope-index-keeps-existing.shexecutablescript2.5 KB
scripts/tests/test-symlink-write-boundary.shexecutablescript6.3 KB
scripts/tests/test-untrusted-git-config.shscript5.0 KB
scripts/tests/test-verification-sidecar.shscript2.7 KB
scripts/validate-structure.shexecutablescript13.3 KB
scripts/verify-commands.shexecutablescript32.5 KB
scripts/verify-content.shexecutablescript13.2 KB

scripts/verify-content.sh

View on GitHub
#!/usr/bin/env bash
# SPDX-License-Identifier: MIT
# SPDX-FileCopyrightText: Netresearch DTT GmbH
# verify-content.sh - Verify AGENTS.md content against actual codebase state
# This script checks if documented information matches reality.
#
# CRITICAL: Never trust existing AGENTS.md content. Always verify.
set -euo pipefail

SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

PROJECT_DIR="${1:-.}"
VERBOSE=false
FIX_MODE=false
JSON=false
EXIT_CODE=0
# Relative path of the AGENTS.md currently being verified; captured into each
# issue's "file" field in JSON mode. Empty => emitted as JSON null.
CURRENT_FILE=""

# Colors
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m'

# Parse flags
while [[ $# -gt 0 ]]; do
    case $1 in
        --verbose|-v)
            VERBOSE=true
            shift
            ;;
        --fix)
            FIX_MODE=true
            shift
            ;;
        --json)
            JSON=true
            shift
            ;;
        --help|-h)
            cat <<EOF
Usage: verify-content.sh [PROJECT_DIR] [OPTIONS]

Verify AGENTS.md content against actual codebase state.

This script extracts information from the actual codebase and compares
it against what's documented in AGENTS.md files. Reports discrepancies
that need manual review or correction.

Options:
  --verbose, -v     Show detailed comparison output
  --fix             Suggest fixes for common issues
  --json            Emit machine-readable JSON on stdout (human output suppressed)
  --help, -h        Show this help message

Verification checks:
  1. Documented files exist (scripts, modules, tests)
  2. Documented commands work (make targets)
  3. Counts are accurate (module count, script count)
  4. Descriptions match actual docstrings

Exit codes:
  0 - All checks passed
  1 - Discrepancies found
  2 - Error running verification

Examples:
  verify-content.sh .                    # Verify current project
  verify-content.sh /path/to/project -v  # Verbose output
  verify-content.sh . --fix              # Show fix suggestions
EOF
            exit 0
            ;;
        *)
            PROJECT_DIR="$1"
            shift
            ;;
    esac
done

cd "$PROJECT_DIR"

# In JSON mode, route all human-readable output to /dev/null and reserve the
# original stdout (fd 3) for the single JSON document emitted at the end. This
# keeps --json strictly additive: the default (no-flag) path is byte-for-byte
# unchanged.
JSON_ISSUES=()
if [[ "$JSON" = true ]]; then
    exec 3>&1 1>/dev/null
fi

echo "Verifying AGENTS.md content in: $(pwd)"
echo ""

# Track issues
declare -a ISSUES=()

add_issue() {
    local severity="$1"
    local message="$2"
    ISSUES+=("[$severity] $message")
    EXIT_CODE=1
    # In JSON mode, also record a structured issue. "message" is stored without
    # the [SEVERITY] prefix; "file" is the AGENTS.md currently under inspection
    # (CURRENT_FILE), coerced to JSON null when empty.
    if [[ "$JSON" = true ]]; then
        JSON_ISSUES+=("$(jq -nc --arg sev "$severity" --arg msg "$message" --arg file "$CURRENT_FILE" \
            '{severity:$sev,message:$msg,file:($file|if .=="" then null else . end)}')")
    fi
}

log_check() {
    if [ "$VERBOSE" = true ]; then
        echo "  Checking: $1"
    fi
}

# ============================================================================
# VERIFICATION FUNCTIONS
# ============================================================================

# shellcheck disable=SC2329  # Called indirectly by verification driver
verify_file_exists() {
    local file="$1"
    local source="$2"
    if [ ! -f "$file" ] && [ ! -d "$file" ]; then
        add_issue "ERROR" "File documented in $source does not exist: $file"
        return 1
    fi
    return 0
}

verify_makefile_target() {
    local target="$1"
    if [ -f "Makefile" ]; then
        # Check in main Makefile and includes
        if ! grep -rq "^${target}:" Makefile Makefile.d/ 2>/dev/null; then
            add_issue "WARN" "Makefile target may not exist: $target"
            return 1
        fi
    fi
    return 0
}

extract_documented_files() {
    local agents_file="$1"
    # Extract file references inside markdown code spans, e.g. `filename.sh`.
    # NOTE: the delimiters must be LITERAL backticks. A previous version used
    # \` which GNU grep interprets as the "start of buffer" anchor, so this
    # check silently matched nothing.
    # shellcheck disable=SC2016  # Literal backticks are intended (markdown code spans), no expansion wanted
    grep -oE '`[a-zA-Z0-9_-]+\.(sh|py|go|php|ts|js|json)`' "$agents_file" 2>/dev/null | tr -d '`' | sort -u || true
}

extract_documented_scripts() {
    local agents_file="$1"
    # Extract script references like install_python.sh, guide.sh
    grep -oE '\b[a-zA-Z0-9_-]+\.sh\b' "$agents_file" 2>/dev/null | sort -u || true
}

# ============================================================================
# ROOT AGENTS.MD VERIFICATION
# ============================================================================

echo "=== Verifying Root AGENTS.md ==="

# Attribute root-section issues to the root AGENTS.md.
CURRENT_FILE="AGENTS.md"

if [ -f "AGENTS.md" ]; then
    echo -e "${GREEN}✓${NC} Root AGENTS.md exists"

    # Check documented make targets
    log_check "Makefile targets"
    # `|| true`: with `set -o pipefail`, a no-match grep makes this pipeline exit
    # non-zero, which under `set -e` aborts the entire script here in the root
    # section -- so the scoped-file loop below never runs. Tolerating the
    # non-zero (as MODULE_COUNTS/SCRIPT_COUNTS already do) lets verification
    # continue. Pre-existing bug: AGENTS.md without 'make ' commands aborted early.
    DOCUMENTED_TARGETS=$(grep -oE 'make [a-z_-]+' AGENTS.md | sed 's/make //' | sort -u || true)
    for target in $DOCUMENTED_TARGETS; do
        verify_makefile_target "$target" || true
    done

    # Check for module count claims
    log_check "Module counts"
    MODULE_COUNTS=$(grep -oE '[0-9]+ (Python )?modules?' AGENTS.md | grep -oE '[0-9]+' || true)
    for count in $MODULE_COUNTS; do
        # Try to find actual module directories
        for dir in src cli_audit lib Classes app; do
            if [ -d "$dir" ]; then
                ACTUAL_COUNT=$(find "$dir" -maxdepth 1 -name "*.py" -o -name "*.php" -o -name "*.go" 2>/dev/null | wc -l)
                if [ "$ACTUAL_COUNT" -gt 0 ] && [ "$count" != "$ACTUAL_COUNT" ]; then
                    add_issue "WARN" "Module count mismatch in $dir: documented=$count, actual=$ACTUAL_COUNT"
                fi
            fi
        done
    done

    # Check for script count claims
    log_check "Script counts"
    SCRIPT_COUNTS=$(grep -oE '[0-9]+ (Bash )?scripts?' AGENTS.md | grep -oE '[0-9]+' || true)
    if [ -d "scripts" ] && [ -n "$SCRIPT_COUNTS" ]; then
        ACTUAL_SCRIPTS=$(find scripts -maxdepth 1 -name "*.sh" 2>/dev/null | wc -l)
        for count in $SCRIPT_COUNTS; do
            if [ "$count" != "$ACTUAL_SCRIPTS" ]; then
                add_issue "WARN" "Script count mismatch: documented=$count, actual=$ACTUAL_SCRIPTS"
            fi
        done
    fi
else
    add_issue "ERROR" "Root AGENTS.md does not exist"
fi

echo ""

# ============================================================================
# SCOPED AGENTS.MD VERIFICATION
# ============================================================================

echo "=== Verifying Scoped AGENTS.md Files ==="

# Find all scoped AGENTS.md files. Dependency trees are excluded, as in
# validate-structure.sh (#84): an AGENTS.md shipped by a package in vendor/,
# node_modules/ or a TYPO3 extension's .Build/vendor/ documents that package,
# not this project, and its file references would be reported as errors here.
SCOPED_FILES=$(find . -mindepth 2 -name "AGENTS.md" \
    -not -path "./.git/*" \
    -not -path "*/vendor/*" \
    -not -path "*/node_modules/*" \
    -not -path "*/.Build/*" \
    2>/dev/null || true)

for scoped_file in $SCOPED_FILES; do
    scope_dir=$(dirname "$scoped_file")
    scope_name=$(basename "$scope_dir")
    # Attribute this iteration's issues to the scoped file (relative, no ./).
    CURRENT_FILE="${scoped_file#./}"
    echo ""
    echo "Checking: $scoped_file"

    # Extract and verify documented files
    log_check "Documented files exist"
    DOCUMENTED=$(extract_documented_files "$scoped_file")

    for doc_file in $DOCUMENTED; do
        # A documented file may live anywhere in the tree (src/, app/, ...), not
        # just the scope dir, so search the whole project for its basename and
        # only flag when it exists NOWHERE. This avoids false positives from the
        # previous narrow 3-location check.
        if ! find . -name "$doc_file" \
                -not -path './.git/*' -not -path '*/node_modules/*' -not -path '*/vendor/*' \
                -not -path '*/.Build/*' \
                -print -quit 2>/dev/null | grep -q .; then
            # Special handling for common false positives
            case "$doc_file" in
                *.json|*.md|*.yml|*.yaml)
                    # Config files might be in various locations, skip
                    ;;
                *)
                    add_issue "ERROR" "File documented in $scoped_file does not exist: $doc_file"
                    ;;
            esac
        fi
    done

    # For scripts/ scope, verify all documented scripts exist
    if [ "$scope_name" = "scripts" ]; then
        log_check "Script files exist"
        SCRIPTS=$(extract_documented_scripts "$scoped_file")
        for script in $SCRIPTS; do
            # Check multiple locations: scripts/, scripts/lib/, ./
            if [ ! -f "scripts/$script" ] && [ ! -f "scripts/lib/$script" ] && [ ! -f "./$script" ]; then
                # Skip if it's in a commit message example (common pattern: feat(scripts): add xxx.sh)
                if grep -q "feat(scripts):.*$script\|fix(scripts):.*$script\|chore(scripts):.*$script" "$scoped_file" 2>/dev/null; then
                    [ "$VERBOSE" = true ] && echo "    Skipping $script (commit message example)"
                    continue
                fi
                add_issue "ERROR" "Script documented but does not exist: $script"
            fi
        done

        # Check for undocumented scripts
        log_check "All scripts documented"
        if [ -d "scripts" ]; then
            for actual_script in scripts/*.sh; do
                script_name=$(basename "$actual_script")
                if ! grep -q "$script_name" "$scoped_file" 2>/dev/null; then
                    add_issue "WARN" "Script exists but not documented: $script_name"
                fi
            done
        fi
    fi

    # For tests/ scope, verify test file listing
    if [ "$scope_name" = "tests" ]; then
        log_check "Test files documented"
        if [ -d "tests" ]; then
            for test_file in tests/test_*.py; do
                if [ -f "$test_file" ]; then
                    test_name=$(basename "$test_file")
                    if ! grep -q "$test_name" "$scoped_file" 2>/dev/null; then
                        add_issue "WARN" "Test file exists but not documented: $test_name"
                    fi
                fi
            done
        fi
    fi

    echo -e "${GREEN}✓${NC} Checked: $scoped_file"
done

# ============================================================================
# JSON OUTPUT
# ============================================================================

# Emit the machine-readable JSON document (to the reserved fd 3) and exit using
# the SAME EXIT_CODE the human path uses. summary.errors/warns are derived from
# the assembled issues array; total mirrors ${#ISSUES[@]}.
if [[ "$JSON" = true ]]; then
    if [[ "${#JSON_ISSUES[@]}" -eq 0 ]]; then
        issues_json='[]'
    else
        issues_json=$(printf '%s\n' "${JSON_ISSUES[@]}" | jq -s '.')
    fi
    jq -nc \
        --argjson items "$issues_json" \
        --argjson total "${#ISSUES[@]}" \
        '{script:"verify-content",schema:1,
          summary:{
            errors:([$items[]|select(.severity=="ERROR")]|length),
            warns:([$items[]|select(.severity=="WARN")]|length),
            total:$total
          },
          issues:$items}' >&3
    exit $EXIT_CODE
fi

# ============================================================================
# SUMMARY
# ============================================================================

echo ""
echo "=== Verification Summary ==="

if [ ${#ISSUES[@]} -eq 0 ]; then
    echo -e "${GREEN}✓ All verification checks passed!${NC}"
else
    echo -e "${RED}Found ${#ISSUES[@]} issue(s):${NC}"
    echo ""
    for issue in "${ISSUES[@]}"; do
        case "$issue" in
            *ERROR*)
                echo -e "  ${RED}$issue${NC}"
                ;;
            *WARN*)
                echo -e "  ${YELLOW}$issue${NC}"
                ;;
            *)
                echo "  $issue"
                ;;
        esac
    done

    if [ "$FIX_MODE" = true ]; then
        echo ""
        echo "=== Fix Suggestions ==="
        echo "1. Run extraction scripts to get actual state:"
        echo "   $SCRIPT_DIR/detect-project.sh ."
        echo "   $SCRIPT_DIR/extract-commands.sh ."
        echo ""
        echo "2. Compare extracted info with AGENTS.md content"
        echo ""
        echo "3. Update AGENTS.md files with verified information"
        echo ""
        echo "4. Re-run this verification: $0 . --verbose"
    fi
fi

echo ""
exit $EXIT_CODE
rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).Stars: 197kUpdated Claude CodeCodexUnverifiedInstall
doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.Stars: 197kUpdated Claude CodeCodexVerifiedInstall