Skip to content

xonika9/agent-skills / .claude/skills/release

release

Verified

Use for this repository when the maintainer asks to prepare or publish a release — «подготовь релиз», «выпусти релиз», "prepare a release", "publish the release". Do not use for ordinary changelog edits, package validation, commits, pushes, or pull requests that are not explicitly a release.

scripts/check_skill_links.py

View on GitHub
#!/usr/bin/env python3
"""Verify that every public skill is linked into the personal skill directories.

Run locally from the repository, or on another machine by piping this file to
`python3 -` with `--names` so the expected set comes from the local candidate.
"""

import argparse
import json
import os
from pathlib import Path


AGENTS_DIR = Path.home() / ".agents/skills"
CLAUDE_DIR = Path.home() / ".claude/skills"


def claude_excluded(root: Path, names: list[str]) -> dict[str, str]:
    """Skills whose onboarding declaration restricts them to runtimes other than Claude Code."""
    excluded = {}
    for name in names:
        declaration = root / name / "references" / "onboarding.json"
        if not declaration.is_file():
            continue
        try:
            supported = json.loads(declaration.read_text(encoding="utf-8")).get("supported_runtimes")
        except (OSError, json.JSONDecodeError) as error:
            raise SystemExit(f"FAIL: cannot read {declaration}: {error}")
        if isinstance(supported, list) and "claude" not in supported:
            excluded[name] = "declared for " + ", ".join(supported)
    return excluded


def repo_skills_root() -> Path:
    return Path(__file__).resolve().parents[4] / "skills"


def discover_root() -> Path:
    """Infer the canonical skills root from existing x9-* links."""
    roots = {
        entry.resolve().parent
        for entry in AGENTS_DIR.glob("x9-*")
        if entry.is_symlink() and (entry.resolve() / "SKILL.md").is_file()
    }
    if len(roots) != 1:
        found = ", ".join(sorted(map(str, roots))) or "none"
        raise SystemExit(f"FAIL: cannot infer one skills root from {AGENTS_DIR} (found: {found})")
    return roots.pop()


def uses_relative_links(directory: Path) -> bool:
    for entry in directory.glob("x9-*"):
        if entry.is_symlink():
            return not os.path.isabs(os.readlink(entry))
    return True


def main() -> None:
    parser = argparse.ArgumentParser()
    parser.add_argument("--names", nargs="+", help="Expected skill names; implies root discovery")
    parser.add_argument("--skills-root", type=Path, help="Canonical skills directory")
    parser.add_argument("--fix", action="store_true", help="Create missing links; never replace entries")
    args = parser.parse_args()

    if args.skills_root:
        root = args.skills_root.resolve()
    elif args.names:
        root = discover_root()
    else:
        root = repo_skills_root()
    names = sorted(args.names or (p.name for p in root.iterdir() if (p / "SKILL.md").is_file()))
    excluded_from_claude = claude_excluded(root, names)

    expected = {
        AGENTS_DIR: {name: root / name for name in names},
        CLAUDE_DIR: {
            name: AGENTS_DIR / name for name in names if name not in excluded_from_claude
        },
    }
    problems, created = [], []

    for directory, targets in expected.items():
        relative = uses_relative_links(directory)
        for name, target in targets.items():
            entry = directory / name
            if os.path.lexists(entry):
                if entry.resolve() != (root / name).resolve() or not (entry / "SKILL.md").is_file():
                    problems.append(f"{entry}: does not resolve to {root / name}")
                continue
            if not (root / name / "SKILL.md").is_file():
                problems.append(f"{entry}: missing, and {root / name} is absent (sync pending?)")
            elif args.fix:
                directory.mkdir(parents=True, exist_ok=True)
                link = os.path.relpath(target, directory) if relative else str(target)
                entry.symlink_to(link)
                created.append(f"{entry} -> {link}")
            else:
                problems.append(f"{entry}: missing")

        for entry in sorted(directory.glob("x9-*")):
            if directory == CLAUDE_DIR and entry.name in excluded_from_claude:
                problems.append(
                    f"{entry}: excluded from Claude Code ({excluded_from_claude[entry.name]})"
                )
                continue
            if entry.name in targets or not entry.is_symlink():
                continue
            if not entry.exists():
                problems.append(f"{entry}: broken link")
            elif entry.resolve().parent == root and entry.name not in names:
                problems.append(f"{entry}: points to a skill that is no longer published")

    for line in created:
        print(f"CREATED: {line}")
    if problems:
        print("FAIL: personal skill links are incomplete:")
        for problem in problems:
            print(f"- {problem}")
        raise SystemExit(1)
    print(f"PASS: {len(names)} skills linked from {AGENTS_DIR} and {CLAUDE_DIR} (Claude Code excludes: {', '.join(excluded_from_claude)})")


if __name__ == "__main__":
    main()
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: 471kUpdated 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: 198kUpdated 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: 198kUpdated 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: 198kUpdated Claude CodeCodexVerifiedInstall