Skip to content

topmindspace/topmind-writing-skills / topmind-briefs

topmind-briefs

Verified

创作 X 与公众号的高信噪比干货短文、经验技巧、提示词交付、快讯改写、新品、榜单、论文解读、规则分析与实测观点。按稿型选择价值前置或体感切口,交付可复制文本;公众号短文通常 300–800 字。纯排版用 topmind-format,互动段子用 topmind-viral-posts,长文用对应平台技能。

FileKindSize
README.en.mdmarkdown2.0 KB
README.mdmarkdown2.2 KB
SKILL.mdskill md6.7 KB
examples/01-X短文-编辑器发布.txtmarkdown591 B
examples/01-链接与配图.txtmarkdown368 B
examples/02-X短文-城市公园.txtmarkdown390 B
examples/03-公众号短文-番茄工作法.mdmarkdown1.1 KB
examples/README.mdmarkdown999 B
knowledge/README.mdmarkdown9.4 KB
knowledge/cards/atlas-local-fix.mdmarkdown781 B
knowledge/cards/brief-news-to-post.mdmarkdown3.0 KB
knowledge/cards/brief-news.mdmarkdown916 B
knowledge/cards/brief-paper.mdmarkdown760 B
knowledge/cards/brief-tools.mdmarkdown617 B
knowledge/cards/brief-value-first.mdmarkdown3.1 KB
knowledge/cards/cover-abstract.mdmarkdown1.3 KB
knowledge/cards/cover-brief.mdmarkdown1.3 KB
knowledge/cards/cover-collage.mdmarkdown1.3 KB
knowledge/cards/cover-color.mdmarkdown1.2 KB
knowledge/cards/cover-culture.mdmarkdown1013 B
knowledge/cards/cover-editorial.mdmarkdown1.2 KB
knowledge/cards/cover-material.mdmarkdown1.3 KB
knowledge/cards/cover-photo.mdmarkdown1.1 KB
knowledge/cards/cover-playful.mdmarkdown1.0 KB
knowledge/cards/cover-scene.mdmarkdown962 B
knowledge/cards/cover-series.mdmarkdown1017 B
knowledge/cards/cover-typography.mdmarkdown1.3 KB
knowledge/cards/creative-choice.mdmarkdown807 B
knowledge/cards/crop-independent.mdmarkdown719 B
knowledge/cards/de-ai-mechanisms.mdmarkdown3.6 KB
knowledge/cards/experience-loop.mdmarkdown801 B
knowledge/cards/format-fidelity.mdmarkdown501 B
knowledge/cards/format-layouts.mdmarkdown502 B
knowledge/cards/poster-paging.mdmarkdown726 B
knowledge/cards/poster-structure.mdmarkdown646 B
knowledge/cards/poster-voices.mdmarkdown530 B
knowledge/cards/reference-reading.mdmarkdown857 B
knowledge/cards/revise-depth.mdmarkdown677 B
knowledge/cards/revise-feedback.mdmarkdown609 B
knowledge/cards/revise-learn-from-edits.mdmarkdown3.1 KB
knowledge/cards/revise-preserve.mdmarkdown788 B
knowledge/cards/viral-mechanisms.mdmarkdown535 B
knowledge/cards/viral-observation.mdmarkdown544 B
knowledge/cards/viral-play-dumb.mdmarkdown2.8 KB
knowledge/cards/viral-replies.mdmarkdown722 B
knowledge/cards/visual-density-and-evidence.mdmarkdown2.8 KB
knowledge/cards/voice-peer-stance.mdmarkdown2.7 KB
knowledge/cards/wechat-decide.mdmarkdown746 B
knowledge/cards/wechat-explain.mdmarkdown820 B
knowledge/cards/wechat-plugin-and-review.mdmarkdown2.5 KB
knowledge/cards/wechat-story.mdmarkdown798 B
knowledge/cards/x-adapt.mdmarkdown643 B
knowledge/cards/x-argument.mdmarkdown770 B
knowledge/cards/x-evidence.mdmarkdown608 B
knowledge/index.jsonconfig39.9 KB
package.jsonmanifest502 B
references/core-voice.mdmarkdown9.9 KB
references/creative-practice.mdmarkdown5.0 KB
references/de-ai-rules.mdmarkdown17.9 KB
references/emoji-system.mdmarkdown1.2 KB
references/examples.mdmarkdown6.4 KB
references/image-sourcing.mdmarkdown2.7 KB
references/information-design.mdmarkdown5.0 KB
references/knowledge-library.mdmarkdown5.5 KB
references/platform-cover-specs.mdmarkdown7.4 KB
references/platform-specs.mdmarkdown1.9 KB
references/research-mode.mdmarkdown1.6 KB
references/revision-workflow.mdmarkdown5.9 KB
references/social-writing-principles.mdmarkdown7.7 KB
references/x-delivery-contract.mdmarkdown3.6 KB
references/x-layout-patterns.mdmarkdown2.3 KB
references/x-post-format.mdmarkdown2.5 KB
scripts/audit_css.pyscript1.1 KB
scripts/audit_docs.pyscript3.1 KB
scripts/audit_skill.pyscript3.1 KB
scripts/audit_styles.pyscript1.6 KB
scripts/check_article.pyscript13.9 KB
scripts/count_words.pyscript3.0 KB
scripts/de_ai_lint.pyscript41.5 KB
scripts/format_text.pyscript9.7 KB
scripts/info_design_hints.pyscript14.2 KB
scripts/knowledge.pyscript11.8 KB
scripts/lint_x_post.pyscript20.0 KB
scripts/md2wechat.pyscript83.6 KB
scripts/md2x-html.pyscript39.8 KB
scripts/negative_tests.pyscript6.0 KB
scripts/package_skill.pyscript6.6 KB
scripts/post_type_report.pyscript9.5 KB
scripts/revise_check.pyscript15.2 KB

scripts/package_skill.py

View on GitHub
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""技能分发包打包器(发布前完整性校验 + 发布清单)。

用法:
    python scripts/package_skill.py            # 校验 → 打包 → 写发布清单
    python scripts/package_skill.py --check    # 只校验不打包(CI / 提交前自检)

产物:
    dist/<skill>.zip            分发包(解压目录名 = 技能名)
    dist/<skill>.manifest.json  发布清单(版本 / 条目 / 大小 / SHA-256)

校验(任一不过 → 退出码 1):
    · SKILL.md frontmatter 含 name / description;name 与目录名一致;
      description ≤ 1024 字符(平台截断阈值)
    · README.md / package.json 存在;package.json name 与技能名一致
    · scripts/*.py 全部可编译;references/*.md 非空
    · SKILL.md 引用的 references/<file> 全部存在
    · 无 scripts/_* / .env 等不应进包的文件
    · 运行时缓存和技能根目录 dist/ 产物不算违规:校验与打包都直接跳过
"""
from __future__ import annotations

import hashlib
import json
import re
import sys
import zipfile
from datetime import datetime, timezone
from pathlib import Path

try:
    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
except Exception:
    pass

ROOT = Path(__file__).resolve().parent.parent
NAME = ROOT.name
OUT = ROOT / "dist" / f"{NAME}.zip"
MANIFEST = ROOT / "dist" / f"{NAME}.manifest.json"
DESC_LIMIT = 1024

INCLUDE = ["SKILL.md", "README.md", "README.en.md", "package.json", "assets/", "references/", "scripts/", "evals/", "agents/", "knowledge/"]
# 运行脚本时自动生成的缓存:既不进包,也不判为违规(CI 先跑负向测试会生成它们)
IGNORE_RES = [
    re.compile(r"^dist(/|$)"),
    re.compile(r"(^|/)__pycache__(/|$)"),
    re.compile(r"\.py[co]$"),
    re.compile(r"(^|/)\.DS_Store$"),
]
EXCLUDE_RES = [
    re.compile(r"(^|/)scripts/_"),
    re.compile(r"(^|/)\.env($|\.)"),
    re.compile(r"(^|/)node_modules(/|$)"),
    re.compile(r"(^|/)dist(/|$)"),
]

errors: list[str] = []


def fail(msg: str) -> None:
    errors.append(msg)
    print(f"  ✗ {msg}")


def ok(msg: str) -> None:
    print(f"  ✓ {msg}")


def read_frontmatter() -> dict:
    text = (ROOT / "SKILL.md").read_text(encoding="utf-8")
    m = re.match(r"^---\r?\n([\s\S]*?)\r?\n---", text)
    if not m:
        fail("SKILL.md 缺 frontmatter")
        return {}
    fm = m.group(1)
    name = re.search(r"^name:\s*(\S+)\s*$", fm, re.M)
    desc = ""
    dm = re.search(r'^description:\s*"([^"]*)"\s*$', fm, re.M)
    if dm:
        desc = dm.group(1).strip()
    else:
        dm = re.search(r"^description:\s*>\-\s*\n((?:[ \t]+.*\n?)+)", fm, re.M)
        if dm:
            desc = " ".join(line.strip() for line in dm.group(1).splitlines() if line.strip())
    return {"name": name.group(1) if name else "", "description": desc}


def check() -> bool:
    print(f"[check] {NAME}")
    fm = read_frontmatter()
    if fm.get("name") != NAME:
        fail(f"frontmatter name={fm.get('name')!r} 与目录名 {NAME!r} 不一致")
    else:
        ok("name 与目录名一致")
    desc = fm.get("description", "")
    if not desc:
        fail("description 为空")
    elif len(desc) > DESC_LIMIT:
        fail(f"description {len(desc)} 字符,超过 {DESC_LIMIT}")
    else:
        ok(f"description {len(desc)} 字符")

    for f in ("README.md", "package.json"):
        if not (ROOT / f).is_file():
            fail(f"缺 {f}")
        else:
            ok(f"有 {f}")
    try:
        pkg = json.loads((ROOT / "package.json").read_text(encoding="utf-8"))
        if pkg.get("name") != NAME:
            fail(f"package.json name={pkg.get('name')!r} 与技能名不一致")
        if not re.match(r"^\d+\.\d+\.\d+", str(pkg.get("version", ""))):
            fail("package.json version 非 semver")
    except (OSError, json.JSONDecodeError) as e:
        fail(f"package.json 解析失败: {e}")

    for p in ROOT.rglob("*"):
        if not p.is_file() or ".git" in p.parts:
            continue
        rel = p.relative_to(ROOT).as_posix()
        if any(rx.search(rel) for rx in IGNORE_RES):
            continue
        for rx in EXCLUDE_RES:
            if rx.search(rel):
                fail(f"不应进包的文件: {rel}")
                break
    ok("无禁用文件")

    for py in sorted((ROOT / "scripts").glob("*.py")):
        try:
            compile(py.read_text(encoding="utf-8"), str(py), "exec")
        except SyntaxError as e:
            fail(f"{py.name} 编译失败: {e}")
    ok("scripts/*.py 编译通过")

    refdir = ROOT / "references"
    if refdir.is_dir():
        for md in sorted(refdir.glob("*.md")):
            if md.stat().st_size == 0:
                fail(f"references/{md.name} 为空")
        skill_text = (ROOT / "SKILL.md").read_text(encoding="utf-8")
        for ref in sorted(set(re.findall(r"references/([\w\-.]+\.md)", skill_text))):
            if not (refdir / ref).is_file():
                fail(f"SKILL.md 引用的 references/{ref} 不存在")
        ok("references 完整性通过")

    if errors:
        print(f"\n[check] {NAME}: {len(errors)} 项失败")
        return False
    print(f"\n[check] {NAME}: 全部通过")
    return True


def package() -> None:
    if not check():
        sys.exit(1)
    (ROOT / "dist").mkdir(exist_ok=True)
    entries: list[str] = []
    with zipfile.ZipFile(OUT, "w", zipfile.ZIP_DEFLATED) as z:
        for p in sorted(ROOT.rglob("*")):
            if not p.is_file() or ".git" in p.parts:
                continue
            rel = p.relative_to(ROOT)
            rel_posix = rel.as_posix()
            if any(rx.search(rel_posix) for rx in IGNORE_RES + EXCLUDE_RES):
                continue
            if not any(
                rel_posix == inc.rstrip("/") or rel_posix.startswith(inc)
                for inc in INCLUDE
                if inc.endswith("/")
            ) and rel_posix not in INCLUDE:
                continue
            z.write(p, arcname=f"{NAME}/{rel_posix}")
            entries.append(rel_posix)
    sha = hashlib.sha256(OUT.read_bytes()).hexdigest()
    pkg = json.loads((ROOT / "package.json").read_text(encoding="utf-8"))
    manifest = {
        "name": NAME,
        "version": pkg.get("version"),
        "built_at": datetime.now(timezone.utc).isoformat(),
        "files": len(entries),
        "sha256": sha,
        "entries": entries,
    }
    MANIFEST.write_text(json.dumps(manifest, ensure_ascii=False, indent=2), encoding="utf-8")
    print(f"\n[package] {OUT} ({len(entries)} 文件, sha256={sha[:12]}…)")


def main() -> None:
    if "--check" in sys.argv[1:]:
        sys.exit(0 if check() else 1)
    package()


if __name__ == "__main__":
    main()
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