feat: improve skill scores for social-autoposter

[rohan-tessl]

Hey @m13v 👋

I ran your skills through tessl skill review at work and found some targeted improvements.

Here's the full before/after:

Skill	Before	After	Change
python-cdp-scripts	10%	90%	+80%
client-website	80%	93%	+13%
posthog-funnel	81%	85%	+4%
browser-script	89%	93%	+4%

This PR covers 4 of your 8 skills to keep the contribution focused and reviewable.

Changes summary

python-cdp-scripts (10% → 90%)

• Added YAML frontmatter — the file had no --- block, causing validation to fail entirely. Added name, description with specific actions (navigates pages, extracts data, scrapes stats, audits posts, calls internal APIs) and explicit trigger terms.

client-website (80% → 93%)

• Split 1307-line monolith into SKILL.md + references/ — extracted component blueprints (Header, Footer, FAQ, case studies, precall page, about page, SVG icons) into references/COMPONENTS.md and typography/color tables into references/DESIGN-SYSTEM.md. Main SKILL.md now serves as a concise orchestration overview (273 lines) with links to detailed references.
• Improved progressive disclosure score from 1/3 to 3/3.

posthog-funnel (81% → 85%)

• Improved description with action verbs — changed from passive "Full product funnel stats" to active "Queries PostHog, Neon Postgres, and Cal.com to compile full product funnel metrics." Added 'conversion rates' trigger term.
• Added error handling section for common failure modes (missing env vars, PostHog API errors, DB connection failures).

browser-script (89% → 93%)

• Improved description specificity — added concrete actions (navigates pages, clicks elements, fills forms, extracts data) and the key performance benefit (replaces 5-10 calls with 2, cutting tokens 10-20x).

Want your remaining skills optimised too? 🚀

This PR covers 4 of your 8 skills to keep the contribution focused and reviewable. We have tooling that can go further:

• Optimize remaining 4 skills automatically (same AI-powered pass as above)
• Add a GitHub Action — tesslio/skill-review-and-optimize — that automatically reviews (and optionally optimizes) any SKILL.md changed in future PRs. Review mode works with zero secrets; maintainers can add TESSL_API_TOKEN for AI suggestions and the /apply-optimize comment flow.

Interested? Just tick the box below and we'll raise a follow-up PR:

• Yes please! Raise a follow-up PR: optimize the remaining 4 skills + add the Tessl skill-review-and-optimize GitHub Action
• No thanks — happy with the 4 skills in this PR

---

Honest disclosure — I work at @tesslio where we build tooling around skills like these. Not a pitch - just saw room for improvement and wanted to contribute.

Want to self-improve your skills? Just point your agent (Claude Code, Codex, etc.) at this Tessl guide and ask it to optimize your skill. Ping me - @rohan-tessl - if you hit any snags.

Thanks in advance 🙏