Skip to content

netresearch/typo3-docs-skill / skills/typo3-docs

typo3-docs

Flagged

Use when TYPO3 extension documentation has to render on docs.typo3.org, which builds a manual from Documentation/guides.xml and reads no Settings.cfg (a single README.rst serves an extension too small for one): when an extension has no documentation yet, or when creating, editing or reviewing Documentation/*.rst, guides.xml, README.md or XLF translations, rendering docs with Docker, TYPO3 RST directives, screenshots, or XLIFF 2-space indentation (TYPO3 v14+).

FileKindSize
SKILL.mdskill md5.9 KB
assets/AGENTS.mdmarkdown11.7 KB
assets/guides.xml.distother1.8 KB
checkpoints.yamlconfig43.1 KB
evals/evals.jsonconfig23.1 KB
references/architecture-decision-records.mdmarkdown6.6 KB
references/asset-templates-guide.mdmarkdown2.8 KB
references/canonical-sources.mdmarkdown6.2 KB
references/code-structure-elements.mdmarkdown7.4 KB
references/coding-guidelines.mdmarkdown7.1 KB
references/content-directives.mdmarkdown7.6 KB
references/documentation-coverage-analysis.mdmarkdown7.6 KB
references/documentation-quality-checks.mdmarkdown3.5 KB
references/extraction-patterns.mdmarkdown23.3 KB
references/file-structure.mdmarkdown7.0 KB
references/guides-xml.mdmarkdown15.9 KB
references/intercept-deployment.mdmarkdown12.5 KB
references/render-guides-development.mdmarkdown8.8 KB
references/rendering.mdmarkdown17.3 KB
references/rst-syntax.mdmarkdown10.5 KB
references/screenshots.mdmarkdown13.1 KB
references/scripts-guide.mdmarkdown3.1 KB
references/text-roles-inline-code.mdmarkdown2.5 KB
references/typo3-directives.mdmarkdown16.0 KB
references/typo3-extension-architecture.mdmarkdown17.4 KB
references/upstream-docs-contribution.mdmarkdown7.5 KB
scripts/add-agents-md.shexecutablescript2.2 KB
scripts/analyze-docs.shexecutablescript12.0 KB
scripts/check-adr-coverage.shexecutablescript778 B
scripts/check-changelog-version-coverage.shexecutablescript1.7 KB
scripts/check-confval-completeness.shexecutablescript2.1 KB
scripts/check-guides-xml-schema.shexecutablescript4.0 KB
scripts/check-guides-xml-version-sync.shexecutablescript1.9 KB
scripts/check-required-doc-sections.shexecutablescript1.6 KB
scripts/check-rst-substitutions-resolve.shexecutablescript5.4 KB
scripts/check-screenshot-freshness.shexecutablescript2.5 KB
scripts/check-settings-documented.shexecutablescript1.5 KB
scripts/check-ui-surface-screenshots.shexecutablescript2.8 KB
scripts/check-untranslated-fluid-strings.shexecutablescript1.6 KB
scripts/check-version-match.shexecutablescript624 B
scripts/extract-all.shexecutablescript4.1 KB
scripts/extract-build-configs.shexecutablescript2.8 KB
scripts/extract-composer.shexecutablescript1.9 KB
scripts/extract-extension-config.shexecutablescript5.0 KB
scripts/extract-php.shexecutablescript5.1 KB
scripts/extract-project-files.shexecutablescript2.0 KB
scripts/extract-repo-metadata.shexecutablescript4.7 KB
scripts/extraction-dir.shexecutablescript1.7 KB
scripts/json-string.shscript921 B
scripts/render_docs.shexecutablescript1.0 KB
scripts/validate_docs.shexecutablescript6.2 KB
scripts/validate_headings.pyexecutablescript4.4 KB

scripts/extract-repo-metadata.sh

View on GitHub
#!/usr/bin/env bash
# SPDX-License-Identifier: MIT
# SPDX-FileCopyrightText: Netresearch DTT GmbH

#
# Extract Repository Metadata
#
# Extracts metadata from GitHub or GitLab using CLI tools:
# - Repository description, topics, stats
# - Recent releases
# - Contributors
# - Open issues (optionally)
#

set -e

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

# Configuration
DATA_DIR="$(bash "$(dirname "${BASH_SOURCE[0]}")/extraction-dir.sh")/data"
CACHE_DIR="$(bash "$(dirname "${BASH_SOURCE[0]}")/extraction-dir.sh")/cache"
OUTPUT_FILE="${DATA_DIR}/repo_metadata.json"
CACHE_FILE="${CACHE_DIR}/repo_metadata.json"

mkdir -p "${DATA_DIR}"
mkdir -p "${CACHE_DIR}"

# Intermediate files go to a private directory (mktemp -d, mode 0700), never
# to fixed names in a shared /tmp.
WORK_DIR="$(mktemp -d)"
trap 'rm -rf "${WORK_DIR}"' EXIT

# Check cache (24 hour TTL)
if [ -f "${CACHE_FILE}" ]; then
    cache_age=$(($(date +%s) - $(stat -c %Y "${CACHE_FILE}" 2>/dev/null || stat -f %m "${CACHE_FILE}" 2>/dev/null || echo 0)))
    if [ $cache_age -lt 86400 ]; then
        echo -e "${YELLOW}Using cached repository metadata (${cache_age}s old)${NC}"
        cp "${CACHE_FILE}" "${OUTPUT_FILE}"
        exit 0
    fi
fi

# Detect repository type
if git remote -v 2>/dev/null | grep -q github.com; then
    REPO_TYPE="github"
    REPO_URL=$(git remote -v | grep github.com | head -1 | sed 's/.*github.com[:/]\(.*\)\.git.*/\1/')
elif git remote -v 2>/dev/null | grep -q gitlab.com; then
    REPO_TYPE="gitlab"
    REPO_URL=$(git remote -v | grep gitlab.com | head -1 | sed 's/.*gitlab.com[:/]\(.*\)\.git.*/\1/')
else
    echo -e "${YELLOW}No GitHub/GitLab remote found, skipping repository metadata${NC}"
    echo '{"repository": {"exists": false}}' > "${OUTPUT_FILE}"
    exit 0
fi

echo "Detected ${REPO_TYPE} repository: ${REPO_URL}"

# Extract based on repository type
if [ "$REPO_TYPE" = "github" ]; then
    # Check if gh CLI is available
    if ! command -v gh &> /dev/null; then
        echo -e "${YELLOW}gh CLI not found, skipping GitHub metadata${NC}"
        echo '{"repository": {"exists": false, "reason": "gh CLI not installed"}}' > "${OUTPUT_FILE}"
        exit 0
    fi

    echo "Extracting GitHub metadata..."

    # Get repository info
    gh api "repos/${REPO_URL}" --jq '{
        extraction_date: now | todate,
        repository: {
            type: "github",
            name: .name,
            full_name: .full_name,
            description: .description,
            topics: .topics,
            stars: .stargazers_count,
            forks: .forks_count,
            open_issues: .open_issues_count,
            created_at: .created_at,
            updated_at: .updated_at,
            homepage: .homepage
        }
    }' > "${OUTPUT_FILE}"

    # Get releases
    gh api "repos/${REPO_URL}/releases?per_page=5" --jq 'map({
        tag: .tag_name,
        name: .name,
        published_at: .published_at,
        prerelease: .prerelease
    })' > "${WORK_DIR}/releases.json"

    # Get contributors
    gh api "repos/${REPO_URL}/contributors?per_page=10" --jq 'map({
        login: .login,
        contributions: .contributions
    })' > "${WORK_DIR}/contributors.json"

    # Merge into output file
    jq --slurpfile releases "${WORK_DIR}/releases.json" --slurpfile contributors "${WORK_DIR}/contributors.json" \
        '. + {releases: $releases[0], contributors: $contributors[0]}' "${OUTPUT_FILE}" > "${WORK_DIR}/merged.json"
    mv "${WORK_DIR}/merged.json" "${OUTPUT_FILE}"

    echo -e "${GREEN}✓ GitHub metadata extracted: ${OUTPUT_FILE}${NC}"

elif [ "$REPO_TYPE" = "gitlab" ]; then
    # Check if glab CLI is available
    if ! command -v glab &> /dev/null; then
        echo -e "${YELLOW}glab CLI not found, skipping GitLab metadata${NC}"
        echo '{"repository": {"exists": false, "reason": "glab CLI not installed"}}' > "${OUTPUT_FILE}"
        exit 0
    fi

    echo "Extracting GitLab metadata..."

    # Get repository info. glab api has no --jq option, so jq shapes the
    # response; under set -e a failed request stops the script here.
    project_json=$(glab api "projects/${REPO_URL//\//%2F}")
    jq '{
        extraction_date: now | todate,
        repository: {
            type: "gitlab",
            name: .name,
            full_name: .path_with_namespace,
            description: .description,
            topics: .topics,
            stars: .star_count,
            forks: .forks_count,
            open_issues: .open_issues_count,
            created_at: .created_at,
            updated_at: .last_activity_at
        }
    }' <<<"$project_json" > "${OUTPUT_FILE}"

    echo -e "${GREEN}✓ GitLab metadata extracted: ${OUTPUT_FILE}${NC}"
fi

# Cache the result
cp "${OUTPUT_FILE}" "${CACHE_FILE}"
echo "Cached metadata for 24 hours"
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall