본문으로 건너뛰기
cccskills
무료GitHub에 공개

sourcesage-cli

Generate AI-friendly repository documentation with the SourceSage CLI. Use when Codex needs to run `sage` or `sourcesage` to create `.SourceSageAssets/Repository_summary.md`, analyze the current repository or another local repository, switch the output language between English and Japanese, use `--lite` to keep the summary small, change the output directory, or optionally create a deprecated tag-diff release report with `--diff`.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

skillmds/skillmd
설치 방법 보기

포함된 파일(15)

  • SKILL.md3.9 KB
  • .gitignore3.4 KB
  • .SourceSageignore2.1 KB
  • AGENTS.md2.4 KB
  • CHANGELOG.md663 B
  • CLAUDE.md3.8 KB
  • CODE_OF_CONDUCT.md788 B
  • CONTRIBUTING.md1.0 KB
  • LICENSE1.0 KB
  • pyproject.toml1.8 KB
  • README.ja.md4.1 KB
  • README.md3.8 KB
  • requirements.txt35 B
  • SECURITY.md566 B
  • test_results.txt1.8 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

SourceSage CLI

Overview

Use the SourceSage CLI from this repository checkout to generate repository summaries for the current repo or another local repo.

Prefer the local checkout over assuming sourcesage is globally installed. In this repository layout, the SourceSage tool root is the directory that contains this SKILL.md.

Workflow

  1. Resolve the SourceSage tool root and the target repository.

    • If the user did not specify another repo, analyze the current workspace.
    • If the current workspace is not the SourceSage repo, run SourceSage from its own checkout with uv run --directory <sourcesage-root> sage ....

  2. Pick the smallest command that satisfies the request.

    • Current repo summary: uv run sage
    • Current repo summary in lite mode: uv run sage --lite
    • Current repo summary in Japanese: uv run sage -l ja
    • Another repo with default output inside that repo: uv run --directory <sourcesage-root> sage --repo "<target-repo>"
    • Another repo in lite mode: uv run --directory <sourcesage-root> sage --repo "<target-repo>" --lite
    • Another repo with explicit output directory: uv run --directory <sourcesage-root> sage --repo "<target-repo>" -o "<output-dir>"
    • Deprecated diff report: uv run --directory <sourcesage-root> sage --repo "<target-repo>" --diff

  3. Verify the generated artifacts after every run.

    • Repository summary: <output-dir>/.SourceSageAssets/Repository_summary.md
    • Deprecated diff report: <output-dir>/.SourceSageAssets/RELEASE_REPORT/Report_<latest-tag>.md
    • Open the generated markdown and summarize the important results instead of only reporting that the command ran.
    • In --lite mode, confirm the summary keeps the tree, Git info, statistics, and root README files while omitting the ## File Contents section.

  4. Report side effects and command mismatches.

    • Expect SourceSage to create <repo>/.SourceSageignore if it does not exist.
    • Treat --ignore-file as the supported ignore override.
    • Do not rely on --use-ignore unless the CLI is updated and re-verified, because the current CLI does not expose that flag.

Command Notes

  • Prefer uv run sage inside the SourceSage repo because pyproject.toml defines both sage and sourcesage entry points.
  • Prefer uv run --directory <sourcesage-root> sage ... outside the SourceSage repo so the command uses this checkout without requiring a global install.
  • Fall back to sourcesage or sage directly only when the package is already installed and uv is unavailable.
  • Use -l ja or -l en for output language.
  • Use --lite for first-pass exploration when ignore rules are not tuned yet or when full file excerpts would make the summary too large.
  • Use -o when the user wants artifacts outside the repo root.
  • Use --repo to analyze another repository from this checkout.

Validation

  • Run the chosen command instead of only describing it.
  • Confirm that the expected markdown file exists.
  • Read the generated output and report the path plus a short summary of what was produced.
  • Re-run the exact command after changing any execution instructions or docs that mention it.

Avoid

  • Do not assume README examples are authoritative when they differ from sourcesage/cli.py.
  • Do not overwrite existing artifacts silently when the user asked for a specific destination and it already contains results.
  • Do not describe SourceSage usage from memory when you can inspect pyproject.toml and sourcesage/cli.py in this repo.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

academic-pptx

무료

Use this skill whenever the user wants to create or improve a presentation for an academic context — conference papers, seminar talks, thesis defenses, grant briefings, lab meetings, invited lectures, or any presentation where the audience will evaluate reasoning and evidence. Triggers include: 'conference talk', 'seminar slides', 'thesis defense', 'research presentation', 'academic deck', 'academic presentation'. Also triggers when the user asks to 'make slides' in combination with academic content (e.g., 'make slides for my paper on X', 'create a presentation for my dissertation defense', 'build a deck for my grant proposal'). This skill governs CONTENT and STRUCTURE decisions. For the technical work of creating or editing the .pptx file itself, also read the pptx SKILL.md.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

skillmds/skillmd2492026년 10월 14일 업데이트

adp

무료

Redpanda's Agentic Data Plane: governance infrastructure for building, running, and governing AI agents and MCP servers, plus a proxying AI Gateway for LLM providers, operated via `rpk ai` and the ADP API. Use when creating or managing AI agents (managed or self-managed) via `rpk ai agent` or `AgentRegistryService`; configuring MCP servers (remote or managed catalog, code mode, auth); setting up LLM providers or querying models via `rpk ai llm`/`rpk ai model` or the AI Gateway proxy; or configuring budgets, guardrails, or Cedar access-control policies through the governance APIs. Also covers reading agent transcripts and spending insights, and wiring OAuth clients or providers to the aigw Authorization Server. For the separate rpk cloud mcp control-plane MCP server, see `/redpanda:rpk-cloud`.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

skillmds/skillmd2492026년 10월 14일 업데이트

ads

무료

Operate professional paid advertising across Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon, Reddit, Pinterest, Snapchat, and X. Use for account intake, source-grounded audits, strategy, budget and measurement planning, creative production, experiments, reporting, monitoring, and explicitly approved campaign changes. Also trigger on PPC, paid social, retail media, attribution, tracking, landing pages, cross-platform conversion totals, negative keywords or search terms, beta-feature scoring, stale platform claims, API-token or credential setup, campaign deletion, and safe Claude Ads installation or uninstall.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

skillmds/skillmd2492026년 10월 14일 업데이트

ads-apple

무료

Audit Apple Ads measurement, AdServices and AdAttributionKit, campaign and keyword structure, Search Match, App Store placements, custom product pages, bidding, budgets, MMP reconciliation, and policy. Use for Apple Ads, Apple Search Ads, App Store ads, Search Match, custom product pages, AdServices, or Apple app-install campaigns.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

skillmds/skillmd2492026년 10월 14일 업데이트

ads-competitor

무료

Research competitor paid-ad presence, messaging, creative, formats, landing pages, keyword and auction signals, transparent ad libraries, and strategic gaps across supported platforms. Use for competitor ads, ad libraries, ad spy, competitive PPC analysis, competitor creative, Google Ads Transparency, Meta Ad Library, or paid-media competitor research.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

skillmds/skillmd2492026년 10월 14일 업데이트

ads-dna

무료

Extract a public-safe brand and offer profile for paid advertising from an authorized website and operator input. Triggers on: brand DNA, brand profile, brand identity, brand style, brand colors, brand voice, visual identity, style guide, website brand analysis.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

skillmds/skillmd2492026년 10월 14일 업데이트

skillmds의 스킬 모두 보기

이 스킬의 문제 신고