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/extract-ci-rules.sh

View on GitHub
#!/usr/bin/env bash
# SPDX-License-Identifier: MIT
# SPDX-FileCopyrightText: Netresearch DTT GmbH
# Extract CI workflow rules that agents need to follow:
# version matrices, quality gates, coverage thresholds, security workflows, linter configs, pinned actions
set -euo pipefail

PROJECT_DIR="${1:-.}"
cd "$PROJECT_DIR"

# ---------------------------------------------------------------------------
# Helpers
# ---------------------------------------------------------------------------

# Collect unique values into a bash array via a nameref
# Usage: collect_unique arr_name "value"
collect_unique() {
    local -n _arr="$1"
    local val="$2"
    for existing in "${_arr[@]+"${_arr[@]}"}"; do
        [[ "$existing" == "$val" ]] && return
    done
    _arr+=("$val")
}

# Turn a bash array into a JSON array via jq
arr_to_json() {
    local -n _a="$1"
    if [[ ${#_a[@]} -eq 0 ]]; then
        echo "[]"
    else
        printf '%s\n' "${_a[@]}" | jq -R . | jq -s .
    fi
}

# Try yq first, fall back to grep/sed parsing
has_yq() { command -v yq &>/dev/null; }

# ---------------------------------------------------------------------------
# GitHub Actions parsing
# ---------------------------------------------------------------------------
# shellcheck disable=SC2034  # the arrays below are read by NAME through
# collect_unique/arr_to_json, which take a nameref; shellcheck cannot follow
# that and reports every one of them as unused.
parse_github_actions() {
    local wf_dir=".github/workflows"
    [[ -d "$wf_dir" ]] || { echo "{}"; return; }

    local php_versions=()
    local node_versions=()
    local go_version=""
    local python_versions=()
    local quality_gates=()
    local required_checks=()
    local linter_configs=()
    local security_workflows=()
    local coverage_threshold=""
    local pinned_actions=true
    local permissions=()

    for wf in "$wf_dir"/*.yml "$wf_dir"/*.yaml; do
        [[ -f "$wf" ]] || continue
        local basename
        basename=$(basename "$wf")

        # --- Security workflows ---
        case "$basename" in
            codeql*|scorecard*|dependency-review*|trivy*|snyk*|semgrep*)
                collect_unique security_workflows "$basename"
                ;;
        esac

        local content
        content=$(<"$wf")

        # --- Pinned actions check ---
        # SHA-pinned: uses: foo/bar@<40-hex-chars>  (may have # vX.Y.Z comment)
        # NOT pinned: uses: foo/bar@v1.2.3 or @main
        # Exclude reusable workflow calls (.github/workflows/) — those often can't be SHA-pinned
        # Strategy: find all uses: lines, exclude reusable workflows, then check if any lack a 40-char hex SHA
        local unpinned_count
        unpinned_count=$(echo "$content" \
            | grep -E '^[[:space:]]*uses:' \
            | grep -vE '\.github/workflows/' \
            | { grep -vE '@[0-9a-f]{40}' || true; } \
            | wc -l)
        if [[ "$unpinned_count" -gt 0 ]]; then
            pinned_actions=false
        fi

        # --- Permissions block ---
        while IFS= read -r line; do
            if [[ "$line" =~ ^[[:space:]]+(contents|pull-requests|security-events|id-token|packages|actions|checks|issues|statuses|deployments):[[:space:]]+(read|write|none) ]]; then
                local perm="${BASH_REMATCH[1]}: ${BASH_REMATCH[2]}"
                collect_unique permissions "$perm"
            fi
        done <<< "$content"

        # --- PHP version matrix ---
        # Matches patterns like: php: ['8.2', '8.3'] or php-version: ['8.2']
        # Also matrix entries like php: [8.2, 8.3]
        while IFS= read -r ver; do
            ver=$(echo "$ver" | tr -d "\"' ")
            [[ -n "$ver" ]] && collect_unique php_versions "$ver"
        done < <(echo "$content" | grep -E '(php|php-version|php_version).*\[' | grep -oE "[0-9]+\.[0-9]+" || true)

        # Single php-version value
        while IFS= read -r ver; do
            ver=$(echo "$ver" | tr -d "\"' ")
            [[ -n "$ver" ]] && collect_unique php_versions "$ver"
        done < <(echo "$content" | grep -E 'php-version:[[:space:]]*[0-9]' | grep -oE "[0-9]+\.[0-9]+" || true)

        # --- Node version matrix ---
        while IFS= read -r ver; do
            ver=$(echo "$ver" | tr -d "\"' ")
            [[ -n "$ver" ]] && collect_unique node_versions "$ver"
        done < <(echo "$content" | grep -E '(node|node-version|node_version).*\[' | grep -oE "[0-9]+" || true)

        while IFS= read -r ver; do
            ver=$(echo "$ver" | tr -d "\"' ")
            [[ -n "$ver" ]] && collect_unique node_versions "$ver"
        done < <(echo "$content" | grep -E 'node-version:[[:space:]]*[0-9]' | grep -oE "[0-9]+" || true)

        # --- Go version ---
        # go-version-file: go.mod  →  read from go.mod
        if echo "$content" | grep -qE 'go-version-file:'; then
            if [[ -f "go.mod" ]]; then
                local gv
                gv=$(grep -E '^go ' go.mod | head -1 | awk '{print $2}')
                [[ -n "$gv" ]] && go_version="$gv"
            fi
        fi
        # Explicit go-version: 1.x
        while IFS= read -r ver; do
            ver=$(echo "$ver" | tr -d "\"' ")
            [[ -n "$ver" ]] && go_version="$ver"
        done < <(echo "$content" | grep -E 'go-version:[[:space:]]*[0-9]' | grep -oE "[0-9]+\.[0-9]+[0-9.]*" | head -1 || true)

        # --- Python version matrix ---
        while IFS= read -r ver; do
            ver=$(echo "$ver" | tr -d "\"' ")
            [[ -n "$ver" ]] && collect_unique python_versions "$ver"
        done < <(echo "$content" | grep -E '(python|python-version).*\[' | grep -oE "[0-9]+\.[0-9]+" || true)

        while IFS= read -r ver; do
            ver=$(echo "$ver" | tr -d "\"' ")
            [[ -n "$ver" ]] && collect_unique python_versions "$ver"
        done < <(echo "$content" | grep -E 'python-version:[[:space:]]*[0-9]' | grep -oE "[0-9]+\.[0-9]+" || true)

        # --- Quality gates (detect from job names and run commands) ---
        # PHPStan
        if echo "$content" | grep -qiE 'phpstan|phpstan\.neon'; then
            # Try to extract level from the command line
            local phpstan_level
            phpstan_level=$(echo "$content" | grep -oE 'phpstan[[:space:]]+analyse.*--level[=[:space:]]*[0-9]+' | grep -oE '[0-9]+$' | head -1 || true)
            if [[ -z "$phpstan_level" ]] && [[ -f "phpstan.neon" || -f "phpstan.neon.dist" || -f "phpstan.dist.neon" ]]; then
                local neon_file
                for neon_file in phpstan.neon phpstan.neon.dist phpstan.dist.neon; do
                    [[ -f "$neon_file" ]] || continue
                    phpstan_level=$(grep -E '^[[:space:]]*level:' "$neon_file" | head -1 | grep -oE '[0-9]+' || true)
                    [[ -n "$phpstan_level" ]] && break
                done
            fi
            if [[ -n "$phpstan_level" ]]; then
                collect_unique quality_gates "phpstan-level-${phpstan_level}"
            else
                collect_unique quality_gates "phpstan"
            fi
        fi

        # PHPUnit / phpunit
        echo "$content" | grep -qiE 'phpunit|ci:test:php:unit' && collect_unique quality_gates "phpunit"

        # Rector
        echo "$content" | grep -qiE 'rector.*--dry-run|ci:test:php:rector' && collect_unique quality_gates "rector-dry-run"

        # PHP-CS-Fixer
        echo "$content" | grep -qiE 'php-cs-fixer|ci:test:php:cgl' && collect_unique quality_gates "php-cs-fixer"

        # golangci-lint
        echo "$content" | grep -qiE 'golangci-lint' && collect_unique quality_gates "golangci-lint"

        # ESLint
        echo "$content" | grep -qiE 'eslint' && collect_unique quality_gates "eslint"

        # Jest / Vitest
        echo "$content" | grep -qiE '\bjest\b|\bvitest\b' && collect_unique quality_gates "jest"

        # pytest
        echo "$content" | grep -qiE '\bpytest\b' && collect_unique quality_gates "pytest"

        # go test
        echo "$content" | grep -qE 'go test' && collect_unique quality_gates "go-test"

        # go vet
        echo "$content" | grep -qE 'go vet' && collect_unique quality_gates "go-vet"

        # govulncheck
        echo "$content" | grep -qiE 'govulncheck' && collect_unique quality_gates "govulncheck"

        # fuzz tests
        echo "$content" | grep -qE '\-fuzz=' && collect_unique quality_gates "fuzz-tests"

        # mutation testing
        echo "$content" | grep -qiE 'mutation|infection' && collect_unique quality_gates "mutation-testing"

        # CodeQL (also a security workflow)
        if echo "$content" | grep -qiE 'codeql'; then
            collect_unique quality_gates "codeql"
            collect_unique security_workflows "$basename"
        fi

        # Trivy
        if echo "$content" | grep -qiE 'trivy'; then
            collect_unique quality_gates "trivy"
            collect_unique security_workflows "$basename"
        fi

        # --- Coverage threshold ---
        # Patterns: THRESHOLD=60, --min-coverage=80, coverage-threshold: 80, fail_ci_if_error
        local threshold
        threshold=$(echo "$content" | grep -oE 'THRESHOLD=[0-9]+\.?[0-9]*' | head -1 | grep -oE '[0-9]+\.?[0-9]*' || true)
        [[ -n "$threshold" && -z "$coverage_threshold" ]] && coverage_threshold="${threshold}%"

        threshold=$(echo "$content" | grep -oE '(--min-coverage|coverage-threshold|minimum_coverage)[=:[:space:]]*[0-9]+' | head -1 | grep -oE '[0-9]+' || true)
        [[ -n "$threshold" && -z "$coverage_threshold" ]] && coverage_threshold="${threshold}%"

        # --- Required checks (from workflow names) ---
        local wf_name
        wf_name=$(echo "$content" | grep -E '^name:' | head -1 | sed 's/^name:[[:space:]]*//')
        [[ -n "$wf_name" ]] && collect_unique required_checks "$wf_name"

        # --- Linter config references ---
        for cfg in .php-cs-fixer.php .php-cs-fixer.dist.php phpstan.neon phpstan.neon.dist phpstan.dist.neon \
                   .eslintrc .eslintrc.js .eslintrc.json eslint.config.js eslint.config.mjs \
                   .golangci.yml .golangci.yaml .prettierrc .prettierrc.json \
                   ruff.toml .flake8 .pylintrc mypy.ini .mypy.ini \
                   .markdownlint.json .markdownlint-cli2.jsonc .yamllint.yml; do
            if [[ -f "$cfg" ]]; then
                collect_unique linter_configs "$cfg"
            fi
        done
    done

    # Build JSON
    local php_json node_json python_json gates_json checks_json linters_json security_json perms_json
    php_json=$(arr_to_json php_versions)
    node_json=$(arr_to_json node_versions)
    python_json=$(arr_to_json python_versions)
    gates_json=$(arr_to_json quality_gates)
    checks_json=$(arr_to_json required_checks)
    linters_json=$(arr_to_json linter_configs)
    security_json=$(arr_to_json security_workflows)
    perms_json=$(arr_to_json permissions)

    jq -n \
        --arg ci_platform "github-actions" \
        --argjson php_versions "$php_json" \
        --argjson node_versions "$node_json" \
        --arg go_version "$go_version" \
        --argjson python_versions "$python_json" \
        --argjson quality_gates "$gates_json" \
        --arg coverage_threshold "$coverage_threshold" \
        --argjson required_checks "$checks_json" \
        --argjson pinned_actions "$pinned_actions" \
        --argjson linter_configs "$linters_json" \
        --argjson security_workflows "$security_json" \
        --argjson permissions "$perms_json" \
        '{
            ci_platform: $ci_platform,
            php_versions: $php_versions,
            node_versions: $node_versions,
            go_version: $go_version,
            python_versions: $python_versions,
            quality_gates: $quality_gates,
            coverage_threshold: $coverage_threshold,
            required_checks: $required_checks,
            pinned_actions: $pinned_actions,
            linter_configs: $linter_configs,
            security_workflows: $security_workflows,
            permissions: $permissions
        } | with_entries(select(.value != "" and .value != [] and .value != null))'
}

# ---------------------------------------------------------------------------
# GitLab CI parsing
# ---------------------------------------------------------------------------
# shellcheck disable=SC2034  # the arrays below are read by NAME through
# collect_unique/arr_to_json, which take a nameref; shellcheck cannot follow
# that and reports every one of them as unused.
parse_gitlab_ci() {
    [[ -f ".gitlab-ci.yml" ]] || { echo "{}"; return; }

    local content
    content=$(<".gitlab-ci.yml")

    local quality_gates=()
    local stages=()

    # Extract stages
    while IFS= read -r line; do
        if [[ "$line" =~ ^[[:space:]]*-[[:space:]]*(.+) ]]; then
            local stage="${BASH_REMATCH[1]}"
            stage=$(echo "$stage" | tr -d "\"' ")
            collect_unique stages "$stage"
        fi
    done < <(sed -n '/^stages:/,/^[^[:space:]-]/p' ".gitlab-ci.yml" | tail -n +2)

    # Detect quality gates from script blocks
    echo "$content" | grep -qiE 'phpstan' && collect_unique quality_gates "phpstan"
    echo "$content" | grep -qiE 'phpunit' && collect_unique quality_gates "phpunit"
    echo "$content" | grep -qiE 'eslint' && collect_unique quality_gates "eslint"
    echo "$content" | grep -qiE 'jest|vitest' && collect_unique quality_gates "jest"
    echo "$content" | grep -qiE 'pytest' && collect_unique quality_gates "pytest"
    echo "$content" | grep -qiE 'golangci-lint' && collect_unique quality_gates "golangci-lint"
    echo "$content" | grep -qE 'go test' && collect_unique quality_gates "go-test"

    local stages_json gates_json
    stages_json=$(arr_to_json stages)
    gates_json=$(arr_to_json quality_gates)

    jq -n \
        --arg ci_platform "gitlab-ci" \
        --argjson stages "$stages_json" \
        --argjson quality_gates "$gates_json" \
        '{
            ci_platform: $ci_platform,
            stages: $stages,
            quality_gates: $quality_gates
        } | with_entries(select(.value != "" and .value != [] and .value != null))'
}

# ---------------------------------------------------------------------------
# Concourse CI parsing
# ---------------------------------------------------------------------------
# shellcheck disable=SC2034  # the arrays below are read by NAME through
# collect_unique/arr_to_json, which take a nameref; shellcheck cannot follow
# that and reports every one of them as unused.
parse_concourse() {
    local pipeline_file=""
    for f in ci/pipeline.yml ci/pipeline.yaml pipeline.yml pipeline.yaml ci/*.yml; do
        [[ -f "$f" ]] && pipeline_file="$f" && break
    done
    [[ -z "$pipeline_file" ]] && { echo "{}"; return; }

    local content
    content=$(<"$pipeline_file")

    local resource_types=()
    local jobs=()

    # Extract resource types
    while IFS= read -r line; do
        if [[ "$line" =~ ^[[:space:]]*-[[:space:]]*name:[[:space:]]*(.+) ]]; then
            collect_unique resource_types "${BASH_REMATCH[1]}"
        fi
    done < <(sed -n '/^resource_types:/,/^[a-z]/p' "$pipeline_file" | tail -n +2)

    # Extract job names
    while IFS= read -r line; do
        if [[ "$line" =~ ^[[:space:]]*-[[:space:]]*name:[[:space:]]*(.+) ]]; then
            collect_unique jobs "${BASH_REMATCH[1]}"
        fi
    done < <(sed -n '/^jobs:/,/^[a-z]/p' "$pipeline_file" | tail -n +2)

    local rt_json jobs_json
    rt_json=$(arr_to_json resource_types)
    jobs_json=$(arr_to_json jobs)

    jq -n \
        --arg ci_platform "concourse" \
        --arg pipeline_file "$pipeline_file" \
        --argjson resource_types "$rt_json" \
        --argjson jobs "$jobs_json" \
        '{
            ci_platform: $ci_platform,
            pipeline_file: $pipeline_file,
            resource_types: $resource_types,
            jobs: $jobs
        } | with_entries(select(.value != "" and .value != [] and .value != null))'
}

# ---------------------------------------------------------------------------
# Detect CI platform and parse
# ---------------------------------------------------------------------------
if [[ -d ".github/workflows" ]]; then
    parse_github_actions
elif [[ -f ".gitlab-ci.yml" ]]; then
    parse_gitlab_ci
elif [[ -f "ci/pipeline.yml" || -f "ci/pipeline.yaml" || -f "pipeline.yml" || -f "pipeline.yaml" ]]; then
    parse_concourse
else
    # No CI detected
    echo '{}'
fi
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: 469kUpdated 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