Skip to content

sergebulaev/facebook-skills

facebook-marketing

Verified

Plan, draft, audit, and publish posts for a Facebook Page. Use when the user wants to write a short punchy Page post or a longer story post, remove AI tells from a draft, reverse-engineer the hook from a high-share Page post, draft replies to comments on their Page, or plan a week of Facebook Page content. Page posts publish via the Publora API. User provides notes or a Facebook Page post URL, the skill drafts, the user approves, then it publishes.

scripts/check_markdown_references.py

View on GitHub
#!/usr/bin/env python3
"""Check Markdown references declared by skill documents.

Every backticked path ending in ``.md`` in the root ``SKILL.md``, the shared
``references/`` tree, and everything under ``skills/`` must resolve either
relative to the citing document (bare sibling ``post-audit.md``, skill-local
``references/X.md`` / ``sub-skills/X.md``, nested ``../../../references/X.md``)
or relative to the repository root (``skills/<skill>/SKILL.md``, ``README.md``).
"""

from __future__ import annotations

from pathlib import Path
import re


ROOT = Path(__file__).resolve().parents[1]
SKILLS = ROOT / "skills"
REFERENCE = re.compile(r"`((?:\.\.?/)*[A-Za-z0-9_.\-]+(?:/[A-Za-z0-9_.\-]+)*\.md)(?:#[^`]*)?`")


def documents() -> list[Path]:
    """Root SKILL.md, shared root references, and everything under skills/."""
    found = [ROOT / "SKILL.md"] if (ROOT / "SKILL.md").is_file() else []
    found += sorted((ROOT / "references").rglob("*.md"))
    found += sorted(SKILLS.rglob("*.md"))
    return found


def resolves(document: Path, ref: str) -> bool:
    return (document.parent / ref).resolve().is_file() or (ROOT / ref).resolve().is_file()


def main() -> None:
    broken: list[str] = []

    for document in documents():
        text = document.read_text(encoding="utf-8")
        for match in REFERENCE.finditer(text):
            ref = match.group(1)
            if "://" in ref or ref.startswith("/"):
                continue
            if not resolves(document, ref):
                broken.append(f"{document.relative_to(ROOT)}: {ref}")

    if broken:
        raise SystemExit("Broken Markdown references:\n" + "\n".join(broken))

    print("All Markdown references resolve.")


if __name__ == "__main__":
    main()
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall