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-commands.sh

View on GitHub
#!/usr/bin/env bash
# SPDX-License-Identifier: MIT
# SPDX-FileCopyrightText: Netresearch DTT GmbH
# Extract build commands from various build tool files
set -euo pipefail

SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
# shellcheck source-path=SCRIPTDIR
# shellcheck disable=SC1091  # the pre-commit hook runs shellcheck without
# -x, so it cannot follow this source no matter how the path is written.
source "$SCRIPT_DIR/lib/config-root.sh"

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

# Stack filter: node, php, go, python, or auto (default)
STACK_FILTER="${2:-auto}"

# Skip extraction functions based on stack
should_extract_node() {
    [[ "$STACK_FILTER" == "auto" || "$STACK_FILTER" == "node" ]]
}

should_extract_php() {
    [[ "$STACK_FILTER" == "auto" || "$STACK_FILTER" == "php" ]]
}

should_extract_go() {
    [[ "$STACK_FILTER" == "auto" || "$STACK_FILTER" == "go" ]]
}

should_extract_python() {
    [[ "$STACK_FILTER" == "auto" || "$STACK_FILTER" == "python" ]]
}

# Get project info (use . since we already cd'd to PROJECT_DIR)
PROJECT_INFO=$(bash "$SCRIPT_DIR/detect-project.sh" ".")
LANGUAGE=$(echo "$PROJECT_INFO" | jq -r '.language')
# shellcheck disable=SC2034  # BUILD_TOOL reserved for future build-tool-specific detection
BUILD_TOOL=$(echo "$PROJECT_INFO" | jq -r '.build_tool')

# Initialize command variables
INSTALL_CMD=""
TYPECHECK_CMD=""
LINT_CMD=""
FORMAT_CMD=""
TEST_CMD=""
TEST_SINGLE_CMD=""
BUILD_CMD=""
DEV_CMD=""

# Detect package manager for Node.js projects
# Workspace-aware: checks workspace root for lockfiles if in a monorepo
PACKAGE_MANAGER="npm"
detect_package_manager() {
    # First, check if we're in a workspace - lockfile will be at workspace root
    local workspace_root
    workspace_root=$(find_node_workspace_root "$(pwd)" || true)
    if [ -n "$workspace_root" ]; then
        if [ -f "$workspace_root/pnpm-lock.yaml" ]; then
            PACKAGE_MANAGER="pnpm"
            return
        elif [ -f "$workspace_root/yarn.lock" ]; then
            PACKAGE_MANAGER="yarn"
            return
        elif [ -f "$workspace_root/bun.lockb" ]; then
            PACKAGE_MANAGER="bun"
            return
        elif [ -f "$workspace_root/package-lock.json" ]; then
            PACKAGE_MANAGER="npm"
            return
        fi
    fi

    # Fallback: check local directory
    if [ -f "pnpm-lock.yaml" ]; then
        PACKAGE_MANAGER="pnpm"
    elif [ -f "yarn.lock" ]; then
        PACKAGE_MANAGER="yarn"
    elif [ -f "bun.lockb" ]; then
        PACKAGE_MANAGER="bun"
    elif [ -f "package.json" ]; then
        # Check packageManager field
        local pm_field
        pm_field=$(jq -r '.packageManager // empty' package.json 2>/dev/null | cut -d@ -f1)
        if [ -n "$pm_field" ]; then
            PACKAGE_MANAGER="$pm_field"
        fi
    fi
}

# Get the run command for package manager
get_pm_run() {
    case "$PACKAGE_MANAGER" in
        pnpm) echo "pnpm" ;;
        yarn) echo "yarn" ;;
        bun) echo "bun run" ;;
        *) echo "npm run" ;;
    esac
}

# Get the npx-equivalent for package manager
get_pm_dlx() {
    case "$PACKAGE_MANAGER" in
        pnpm) echo "pnpm dlx" ;;
        yarn) echo "yarn dlx" ;;
        bun) echo "bunx" ;;
        *) echo "npx" ;;
    esac
}

# Extract from Makefile
extract_from_makefile() {
    [ ! -f "Makefile" ] && return 0

    # Extract targets with ## comments
    while IFS= read -r line; do
        if [[ $line =~ ^([a-zA-Z_-]+):.*\#\#(.*)$ ]]; then
            target="${BASH_REMATCH[1]}"
            # description captured but not yet used (for future enhanced output)
            # description="${BASH_REMATCH[2]}"

            case "$target" in
                lint|check) LINT_CMD="make $target" ;;
                format|fmt) FORMAT_CMD="make $target" ;;
                test|tests) TEST_CMD="make $target" ;;
                build) BUILD_CMD="make $target" ;;
                typecheck|types) TYPECHECK_CMD="make $target" ;;
                dev|serve) DEV_CMD="make $target" ;;
            esac
        fi
    done < Makefile
}

# Extract from package.json
extract_from_package_json() {
    [ ! -f "package.json" ] && return 0

    # Detect package manager first
    detect_package_manager

    local pm_run pm_dlx
    pm_run=$(get_pm_run)
    pm_dlx=$(get_pm_dlx)

    # Set install command based on package manager
    INSTALL_CMD="$PACKAGE_MANAGER install"

    local typecheck_key has_lint has_format has_test has_build dev_key
    typecheck_key=$(package_script_key typecheck "type-check")
    has_lint=$(jq -r '.scripts.lint // empty' package.json 2>/dev/null)
    has_format=$(jq -r '.scripts.format // empty' package.json 2>/dev/null)
    has_test=$(jq -r '.scripts.test // empty' package.json 2>/dev/null)
    has_build=$(jq -r '.scripts.build // empty' package.json 2>/dev/null)
    dev_key=$(package_script_key dev start)

    if [ -n "$typecheck_key" ]; then
        TYPECHECK_CMD="$pm_run $typecheck_key"
    else
        TYPECHECK_CMD="$pm_dlx tsc --noEmit"
    fi

    if [ -n "$has_lint" ]; then
        LINT_CMD="$pm_run lint"
    else
        LINT_CMD="$pm_dlx eslint ."
    fi

    if [ -n "$has_format" ]; then
        FORMAT_CMD="$pm_run format"
    else
        FORMAT_CMD="$pm_dlx prettier --write ."
    fi

    if [ -n "$has_test" ]; then
        TEST_CMD="$PACKAGE_MANAGER test"
        # Single file test command
        if grep -q 'vitest' package.json 2>/dev/null; then
            TEST_SINGLE_CMD="$pm_dlx vitest run"
        elif grep -q 'jest' package.json 2>/dev/null; then
            TEST_SINGLE_CMD="$pm_dlx jest"
        else
            TEST_SINGLE_CMD="$PACKAGE_MANAGER test --"
        fi
    fi

    if [ -n "$has_build" ]; then
        BUILD_CMD="$pm_run build"
    fi

    if [ -n "$dev_key" ]; then
        DEV_CMD="$pm_run $dev_key"
    fi
}

# Print the first script key that the given manifest actually defines, or
# nothing. Callers emit `<runner> <key>`, so the key has to be the one that
# exists — accepting `cs:fix` as evidence and then printing `format` writes a
# command the project does not have.
manifest_script_key() {
    local manifest="$1"
    shift
    local key
    for key in "$@"; do
        if jq -e --arg k "$key" '.scripts[$k] // empty' "$manifest" >/dev/null 2>&1; then
            printf '%s' "$key"
            return 0
        fi
    done
    return 0
}

composer_script_key() { manifest_script_key composer.json "$@"; }
package_script_key() { manifest_script_key package.json "$@"; }

# Extract from composer.json
extract_from_composer_json() {
    [ ! -f "composer.json" ] && return 0

    local lint_key format_key test_key phpstan_key

    # Emit the script that EXISTS, not the first name we looked for. Accepting
    # `cs:fix` as evidence and then printing `composer run format` produces a
    # command the project does not define, and AGENTS.md presents it as fact.
    lint_key=$(composer_script_key lint "cs:check")
    format_key=$(composer_script_key format "cs:fix")
    test_key=$(composer_script_key test)
    phpstan_key=$(composer_script_key phpstan stan)

    if [ -n "$lint_key" ]; then
        LINT_CMD="composer run $lint_key"
    fi

    if [ -n "$format_key" ]; then
        FORMAT_CMD="composer run $format_key"
    fi

    if [ -n "$test_key" ]; then
        TEST_CMD="composer run $test_key"
    else
        TEST_CMD="vendor/bin/phpunit"
    fi

    if [ -n "$phpstan_key" ]; then
        TYPECHECK_CMD="composer run $phpstan_key"
    elif [ -f "phpstan.neon" ] || [ -f "Build/phpstan.neon" ]; then
        TYPECHECK_CMD="vendor/bin/phpstan analyze"
    fi
}

# Extract from pyproject.toml
extract_from_pyproject() {
    [ ! -f "pyproject.toml" ] && return 0

    # Check for ruff
    if grep -q '\[tool.ruff\]' pyproject.toml; then
        LINT_CMD="ruff check ."
        FORMAT_CMD="ruff format ."
    fi

    # Check for black
    if grep -q 'black' pyproject.toml; then
        FORMAT_CMD="black ."
    fi

    # Check for mypy
    if grep -q 'mypy' pyproject.toml; then
        TYPECHECK_CMD="mypy ."
    fi

    # Check for pytest
    if grep -q 'pytest' pyproject.toml; then
        TEST_CMD="pytest"
    fi
}

# Language-specific defaults
set_language_defaults() {
    case "$LANGUAGE" in
        "go")
            : "${INSTALL_CMD:=go mod download}"
            : "${TYPECHECK_CMD:=go build -v ./...}"
            if [ -z "$LINT_CMD" ]; then
                if [ -f ".golangci.yml" ] || [ -f ".golangci.yaml" ]; then
                    LINT_CMD="golangci-lint run ./..."
                fi
            fi
            : "${FORMAT_CMD:=gofmt -w .}"
            : "${TEST_CMD:=go test -v -race -short ./...}"
            : "${TEST_SINGLE_CMD:=go test -v -race}"
            : "${BUILD_CMD:=go build -v ./...}"
            ;;

        "php")
            : "${INSTALL_CMD:=composer install}"
            if [ -z "$TYPECHECK_CMD" ]; then
                if [ -f "phpstan.neon" ] || [ -f "Build/phpstan.neon" ]; then
                    TYPECHECK_CMD="vendor/bin/phpstan analyze"
                fi
            fi
            : "${LINT_CMD:=vendor/bin/php-cs-fixer fix --dry-run}"
            : "${FORMAT_CMD:=vendor/bin/php-cs-fixer fix}"
            : "${TEST_CMD:=vendor/bin/phpunit}"
            : "${TEST_SINGLE_CMD:=vendor/bin/phpunit}"
            ;;

        "typescript")
            local pm_dlx
            pm_dlx=$(get_pm_dlx)
            : "${INSTALL_CMD:=$PACKAGE_MANAGER install}"
            : "${TYPECHECK_CMD:=$pm_dlx tsc --noEmit}"
            : "${LINT_CMD:=$pm_dlx eslint .}"
            : "${FORMAT_CMD:=$pm_dlx prettier --write .}"
            if [ -z "$TEST_CMD" ]; then
                if [ -f "jest.config.js" ] || [ -f "jest.config.ts" ]; then
                    TEST_CMD="$PACKAGE_MANAGER test"
                    TEST_SINGLE_CMD="$pm_dlx jest"
                elif grep -q 'vitest' package.json 2>/dev/null; then
                    TEST_CMD="$pm_dlx vitest run"
                    TEST_SINGLE_CMD="$pm_dlx vitest run"
                fi
            fi
            ;;

        "python")
            if [ -f "pyproject.toml" ]; then
                if grep -q '\[tool.poetry\]' pyproject.toml 2>/dev/null; then
                    INSTALL_CMD="poetry install"
                elif grep -q '\[tool.uv\]' pyproject.toml 2>/dev/null; then
                    INSTALL_CMD="uv sync"
                else
                    INSTALL_CMD="pip install -e ."
                fi
            else
                INSTALL_CMD="pip install -r requirements.txt"
            fi
            : "${LINT_CMD:=ruff check .}"
            : "${FORMAT_CMD:=ruff format .}"
            : "${TYPECHECK_CMD:=mypy .}"
            : "${TEST_CMD:=pytest}"
            : "${TEST_SINGLE_CMD:=pytest}"
            ;;
    esac
}

# Run extraction (stack-filtered)
extract_from_makefile  # Always extract Makefile (cross-stack)
should_extract_node && extract_from_package_json
should_extract_php && extract_from_composer_json
should_extract_python && extract_from_pyproject

# Only set language defaults if matching stack or auto
case "$STACK_FILTER" in
    "auto") set_language_defaults ;;
    "node") [[ "$LANGUAGE" == "typescript" || "$LANGUAGE" == "javascript" ]] && set_language_defaults ;;
    "php") [[ "$LANGUAGE" == "php" ]] && set_language_defaults ;;
    "go") [[ "$LANGUAGE" == "go" ]] && set_language_defaults ;;
    "python") [[ "$LANGUAGE" == "python" ]] && set_language_defaults ;;
    *)
        echo "ERROR: Invalid STACK_FILTER value: $STACK_FILTER" >&2
        echo "Valid options: auto, node, php, go, python" >&2
        exit 1
        ;;
esac

# Output JSON
jq -n \
    --arg install "$INSTALL_CMD" \
    --arg typecheck "$TYPECHECK_CMD" \
    --arg lint "$LINT_CMD" \
    --arg format "$FORMAT_CMD" \
    --arg test "$TEST_CMD" \
    --arg test_single "$TEST_SINGLE_CMD" \
    --arg build "$BUILD_CMD" \
    --arg dev "$DEV_CMD" \
    --arg package_manager "$PACKAGE_MANAGER" \
    '{
        install: $install,
        typecheck: $typecheck,
        lint: $lint,
        format: $format,
        test: $test,
        test_single: $test_single,
        build: $build,
        dev: $dev,
        package_manager: $package_manager
    }'
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