Skip to content

sergebulaev/tiktok-skills / .codex-marketplace/tiktok-skills

tiktok-marketing

Verified

Plan, script, caption, and publish short-form video for TikTok. Use when the user wants to write the first 1-3 second hook (spoken line plus on-screen text), draft a caption under 2,200 chars with TikTok settings and hashtags, ride a trending sound without being cringe, strip AI tells from a spoken script to sound human on camera, or plan a week around completion rate. TikTok is video-only: the user supplies the video, the skills produce the script, caption, and settings, then publish via Publora.

scripts/check_frontmatter.py

View on GitHub
#!/usr/bin/env python3
"""Parse every SKILL.md frontmatter with a strict YAML loader.

Counting directories does not tell you a skill loads. In v1.0.26 an
unescaped apostrophe inside a single-quoted `description` terminated the
scalar early, the frontmatter failed to parse, and the loader skipped the
directory in silence: users got 10 of 11 skills with no error anywhere,
while sibling skills kept pointing at the one that had vanished.

Long prose descriptions outgrow whichever quoting style they were written
in, so this checks what a strict loader sees rather than trusting the
style. Reported by @FSLATT1 (linkedin-skills#21).

Usage: python3 scripts/check_frontmatter.py
"""

from __future__ import annotations

import json
import re
import sys
from pathlib import Path

try:
    import yaml
except ImportError:  # pragma: no cover
    print("PyYAML is required: pip install pyyaml", file=sys.stderr)
    raise SystemExit(2)

ROOT = Path(__file__).resolve().parents[1]
FRONTMATTER = re.compile(r"\A---\n(.*?)\n---\n", re.S)
REQUIRED = ("name", "description")


def documents() -> list[Path]:
    docs = sorted((ROOT / "skills").glob("*/SKILL.md"))
    root = ROOT / "SKILL.md"
    if root.is_file():
        docs.append(root)
    return docs


def declared_skill_count() -> int | None:
    """The skill count the plugin manifest publishes, from its description."""
    manifest = ROOT / ".claude-plugin" / "plugin.json"
    if not manifest.is_file():
        return None
    try:
        description = json.loads(manifest.read_text(encoding="utf-8"))["description"]
    except (json.JSONDecodeError, KeyError, OSError):
        return None
    match = re.match(r"\s*(\d+)\b", description)
    return int(match.group(1)) if match else None


def main() -> int:
    problems: list[str] = []
    docs = documents()

    for path in docs:
        rel = path.relative_to(ROOT)
        match = FRONTMATTER.match(path.read_text(encoding="utf-8"))
        if not match:
            problems.append(f"{rel}: no YAML frontmatter block")
            continue
        try:
            data = yaml.safe_load(match.group(1))
        except yaml.YAMLError as exc:
            detail = str(exc).splitlines()[0]
            problems.append(f"{rel}: frontmatter does not parse ({detail})")
            continue
        if not isinstance(data, dict):
            problems.append(f"{rel}: frontmatter is not a mapping")
            continue
        for key in REQUIRED:
            value = data.get(key)
            if not isinstance(value, str) or not value.strip():
                problems.append(f"{rel}: '{key}' is missing or empty")
        name = data.get("name")
        if isinstance(name, str) and path.parent != ROOT and name != path.parent.name:
            problems.append(f"{rel}: name '{name}' does not match folder '{path.parent.name}'")

    if problems:
        print("Frontmatter problems:\n" + "\n".join("  " + p for p in problems))
        return 1

    skills = [d for d in docs if d.parent != ROOT]

    # Counting what happens to be there proves nothing: a bundle that loses a
    # skill still passes, and `ls skills/ | wc -l` can be satisfied by a stray
    # file that is not a skill at all. Compare against the number the plugin
    # manifest publishes, which is the number users are promised.
    declared = declared_skill_count()
    if declared is not None and declared != len(skills):
        print(f"Skill count mismatch: the manifest promises {declared} skills, "
              f"{len(skills)} directories contain a loadable SKILL.md.")
        return 1

    print(f"OK: {len(skills)} skills plus the root document parse and declare "
          f"name and description"
          + (f", matching the {declared} the manifest promises." if declared
             else "."))
    return 0


if __name__ == "__main__":
    sys.exit(main())
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall