Skip to content

EliasOulkadi/shokunin / .pack/skills/kami

FileKindSize
.claude-plugin/marketplace.jsonconfig537 B
.github/FUNDING.ymlconfig61 B
.github/workflows/check.ymlconfig673 B
.github/workflows/release.ymlconfig1.4 KB
.gitignoreother436 B
CHEATSHEET.mdmarkdown15.6 KB
LICENSEother1.0 KB
README.mdmarkdown9.2 KB
SKILL.mdskill md30.3 KB
assets/demos/demo-agent-slides.htmlother22.1 KB
assets/demos/demo-agent-slides.pdfbinary96.7 KB
assets/demos/demo-agent-slides.pngbinary156.3 KB
assets/demos/demo-kaku.htmlother27.9 KB
assets/demos/demo-kaku.pdfbinary1.1 MB
assets/demos/demo-kaku.pngbinary86.5 KB
assets/demos/demo-musk-resume.htmlother24.0 KB
assets/demos/demo-musk-resume.pdfbinary336.1 KB
assets/demos/demo-musk-resume.pngbinary417.3 KB
assets/demos/demo-tesla.htmlother22.3 KB
assets/demos/demo-tesla.pdfbinary301.7 KB
assets/demos/demo-tesla.pngbinary313.0 KB
assets/demos/equity-report-en.pngbinary368.5 KB
assets/demos/images/kaku-action.jpgbinary949.2 KB
assets/demos/images/kaku-hero.jpgbinary460.5 KB
assets/diagrams/architecture.htmlother9.1 KB
assets/diagrams/bar-chart.htmlother8.3 KB
assets/diagrams/candlestick.htmlother10.0 KB
assets/diagrams/donut-chart.htmlother7.8 KB
assets/diagrams/flowchart.htmlother7.7 KB
assets/diagrams/layer-stack.htmlother7.9 KB
assets/diagrams/line-chart.htmlother10.1 KB
assets/diagrams/quadrant.htmlother7.7 KB
assets/diagrams/state-machine.htmlother9.5 KB
assets/diagrams/swimlane.htmlother8.8 KB
assets/diagrams/timeline.htmlother7.2 KB
assets/diagrams/tree.htmlother9.9 KB
assets/diagrams/venn.htmlother5.6 KB
assets/diagrams/waterfall.htmlother8.9 KB
assets/fonts/JetBrainsMono.woff2binary54.4 KB
assets/fonts/TsangerJinKai02-W04.ttfbinary18.1 MB
assets/fonts/TsangerJinKai02-W05.ttfbinary18.1 MB
assets/illustrations/travel-3d-representations.pngbinary2.0 MB
assets/illustrations/travel-spatialvla.pngbinary1.8 MB
assets/illustrations/travel-tesla-optimus.pngbinary1.8 MB
assets/images/logo.svgother8.7 KB
assets/templates/changelog-en.htmlother5.8 KB
assets/templates/changelog.htmlother6.6 KB
assets/templates/equity-report-en.htmlother12.5 KB
assets/templates/equity-report.htmlother13.6 KB
assets/templates/letter-en.htmlother7.2 KB
assets/templates/letter.htmlother8.3 KB
assets/templates/long-doc-en.htmlother13.8 KB
assets/templates/long-doc.htmlother15.6 KB
assets/templates/one-pager-en.htmlother9.4 KB
assets/templates/one-pager.htmlother10.9 KB
assets/templates/portfolio-en.htmlother15.7 KB
assets/templates/portfolio.htmlother16.7 KB
assets/templates/resume-en.htmlother23.8 KB
assets/templates/resume.htmlother25.6 KB
assets/templates/slides-en.pyscript13.5 KB
assets/templates/slides-weasy-en.htmlother6.9 KB
assets/templates/slides-weasy.htmlother7.8 KB
assets/templates/slides.pyscript14.6 KB
index-en.htmlother485 B
index-ja.htmlother43.4 KB
index-zh.htmlother41.1 KB
index.htmlother40.9 KB
llms.txtmarkdown1.6 KB
long-doc-en-template.htmlother13.8 KB
references/anti-patterns.mdmarkdown4.2 KB
references/brand-profile.mdmarkdown4.5 KB
references/brand.example.mdmarkdown2.8 KB
references/design.mdmarkdown30.5 KB
references/diagrams.mdmarkdown18.6 KB
references/production.mdmarkdown30.0 KB
references/resume-writing.mdmarkdown6.8 KB
references/stabilizer_profiles.jsonconfig3.2 KB
references/tokens.jsonconfig471 B
references/writing.mdmarkdown23.1 KB
robots.txtmarkdown708 B
scripts/build.pyscript33.8 KB
scripts/draft-release-notes.pyscript5.6 KB
scripts/ensure-fonts.shscript3.2 KB
scripts/package-skill.shscript850 B
scripts/shared.pyscript4.7 KB
scripts/stabilize.pyscript26.1 KB
scripts/tests/test_build.pyscript14.7 KB
sitemap.xmlconfig879 B
styles.cssother26.1 KB
vercel.jsonconfig121 B

scripts/draft-release-notes.py

View on GitHub
#!/usr/bin/env python3
"""Draft the next Kami release notes from git log.

Pulls commit subjects in a rev range and pours them into the V1.4.0-style
template (centered logo + bilingual changelog). The output is a starting
point: regroup the commits into 5-8 product-themed bullets and translate
each to Chinese before publishing.

Usage:
    python3 scripts/draft-release-notes.py
    python3 scripts/draft-release-notes.py V1.4.0..HEAD
    python3 scripts/draft-release-notes.py \\
        --version V1.5.0 \\
        --title "Steadier Hand" \\
        --subtitle-en "Plugin install fix and audit cleanup." \\
        --subtitle-cn "插件安装修复,审计清理沉淀。"

The default rev range is `<latest tag>..HEAD`. Output goes to stdout; pipe
to a file or `pbcopy` to feed `gh release create --notes-file`.
"""
from __future__ import annotations

import argparse
import subprocess
import sys
from textwrap import dedent

_HEADER = dedent("""\
    <div align="center">
      <img src="https://gw.alipayobjects.com/zos/k/vl/logo.svg" alt="Kami Logo" width="120" />
      <h1 style="margin: 12px 0 6px;">Kami {version}</h1>
      <p><em>{subtitle_en}</em></p>
    </div>
""")

_FOOTER = dedent("""\
    > Kami is a quiet design system for professional documents, one constraint set that any agent can trust. https://github.com/tw93/Kami
""")

# Conventional-commit prefix to a short product label, used as a hint when
# the user reorganizes the auto-listed commits into themed bullets.
_PREFIX_HINT = {
    "build": "build",
    "ci": "ci",
    "feat": "feature",
    "fix": "fix",
    "docs": "docs",
    "chore": "chore",
    "refactor": "refactor",
    "test": "test",
    "perf": "perf",
    "revert": "revert",
}


def _run(cmd: list[str]) -> str:
    result = subprocess.run(cmd, capture_output=True, text=True, check=False)
    if result.returncode != 0:
        raise RuntimeError(f"{' '.join(cmd)}: {result.stderr.strip() or 'failed'}")
    return result.stdout


def latest_tag() -> str | None:
    try:
        out = _run(["git", "describe", "--tags", "--abbrev=0"]).strip()
    except RuntimeError:
        return None
    return out or None


def commits_in(rev_range: str) -> list[tuple[str, str]]:
    """Return [(short_sha, subject), ...] in chronological order."""
    out = _run(["git", "log", rev_range, "--format=%h\t%s", "--reverse"])
    rows: list[tuple[str, str]] = []
    for line in out.splitlines():
        if "\t" in line:
            sha, subject = line.split("\t", 1)
            rows.append((sha.strip(), subject.strip()))
    return rows


def classify(subject: str) -> str:
    """Return a one-word commit category derived from the conventional-commit prefix."""
    head = subject.split(":", 1)[0].split("(", 1)[0].strip().lower()
    return _PREFIX_HINT.get(head, "other")


def render(
    version: str,
    title: str,
    subtitle_en: str,
    subtitle_cn: str,
    rev_range: str,
    commits: list[tuple[str, str]],
) -> str:
    out: list[str] = []
    out.append(_HEADER.format(version=version, subtitle_en=subtitle_en))
    out.append(f"<!-- title: {version} {title} -->")
    out.append(f"<!-- range: {rev_range} ({len(commits)} commits) -->")
    out.append("<!-- regroup the bullets below into 5-8 product-themed items -->")
    out.append("")
    out.append("### Changelog")
    out.append("")
    for i, (sha, subject) in enumerate(commits, 1):
        out.append(f"{i}. **TODO**: {subject}  <!-- {sha} {classify(subject)} -->")
    out.append("")
    out.append("### 更新日志")
    out.append("")
    out.append(f"<!-- 副标题: {subtitle_cn} -->")
    out.append("<!-- 翻译并对齐到上面英文条目,保持一一对应 -->")
    out.append("")
    for i in range(1, len(commits) + 1):
        out.append(f"{i}. **TODO**:(对应英文第 {i} 条)")
    out.append("")
    out.append(_FOOTER)
    return "\n".join(out)


def parse_args(argv: list[str]) -> argparse.Namespace:
    parser = argparse.ArgumentParser(
        description=__doc__,
        formatter_class=argparse.RawDescriptionHelpFormatter,
    )
    parser.add_argument(
        "rev_range",
        nargs="?",
        default=None,
        help="Git rev range (default: <latest tag>..HEAD)",
    )
    parser.add_argument("--version", default="VX.Y.Z", help="Version label, e.g. V1.5.0")
    parser.add_argument("--title", default="<title>", help="Release title, e.g. 'Steadier Hand'")
    parser.add_argument(
        "--subtitle-en",
        default="<one-line subtitle>",
        help="Short English subtitle for the centered hero block",
    )
    parser.add_argument(
        "--subtitle-cn",
        default="<一句话中文副标题>",
        help="Short Chinese subtitle, kept as a comment hint for translators",
    )
    return parser.parse_args(argv[1:])


def main(argv: list[str]) -> int:
    args = parse_args(argv)

    rev_range = args.rev_range
    if rev_range is None:
        tag = latest_tag()
        if not tag:
            print("ERROR: no tag found; pass an explicit rev range like V1.0.0..HEAD",
                  file=sys.stderr)
            return 2
        rev_range = f"{tag}..HEAD"

    try:
        commits = commits_in(rev_range)
    except RuntimeError as exc:
        print(f"ERROR: {exc}", file=sys.stderr)
        return 2

    if not commits:
        print(f"ERROR: no commits in {rev_range}", file=sys.stderr)
        return 1

    out = render(
        version=args.version,
        title=args.title,
        subtitle_en=args.subtitle_en,
        subtitle_cn=args.subtitle_cn,
        rev_range=rev_range,
        commits=commits,
    )
    print(out)
    return 0


if __name__ == "__main__":
    sys.exit(main(sys.argv))
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall