Eating my own dog food
The skills this site runs on
Every post, audio narration, social video, and background image on twistedbrackets.com is produced by an AI agent following one of these skills - and UI surfaces can be scored against the same UX laws documented on this site. They live in the site repo's .skills/ folder in the dot-skills format - one canonical copy, symlinked into Claude Code and Cursor, and installable into your own project with a single command.
These are separate from the development harness skills, which cover the general design-to-ship workflow and have their own catalogue. The skills below are the site's own content pipeline.
Install
Grab them with dot-skills
Browse what's available, then install everything or pick one skill at a time. Each block below has a copy button. Some skills declare environment-variable dependencies - npx dot-skills doctor will tell you what's missing after install.
List or install all
npx dot-skills list levi-putna/twistedbrackets.com
npx dot-skills add levi-putna/twistedbrackets.comUI Laws (design + audit)
Design-concept feedback and scored audits against this site's Laws of UX.
npx dot-skills add levi-putna/twistedbrackets.com/ui-laws-auditInstall one skill
npx dot-skills add levi-putna/twistedbrackets.com/write-blog-post
npx dot-skills add levi-putna/twistedbrackets.com/general-writing
npx dot-skills add levi-putna/twistedbrackets.com/blog-fact-check
npx dot-skills add levi-putna/twistedbrackets.com/blog-audio-script
npx dot-skills add levi-putna/twistedbrackets.com/blog-audio-generate
npx dot-skills add levi-putna/twistedbrackets.com/blog-social-teaser
npx dot-skills add levi-putna/twistedbrackets.com/blog-social-video
npx dot-skills add levi-putna/twistedbrackets.com/storyboard-video
npx dot-skills add levi-putna/twistedbrackets.com/video-generate-explainer
npx dot-skills add levi-putna/twistedbrackets.com/bg-image
npx dot-skills add levi-putna/twistedbrackets.com/screenshot-image
npx dot-skills add levi-putna/twistedbrackets.com/ui-laws-audit
npx dot-skills add levi-putna/twistedbrackets.com/responsive-layout-audit
npx dot-skills add levi-putna/twistedbrackets.com/solid
npx dot-skills add levi-putna/twistedbrackets.com/seo
npx dot-skills add levi-putna/twistedbrackets.com/creating-skills
npx dot-skills add levi-putna/twistedbrackets.com/importing-skillsCatalogue
17 skills, 6 pipelines
Writing & publishing
Drafting, editing, and verifying posts before they ship.
Write Blog Post
End-to-end pipeline for a new blog post: gated stages from idea refinement through outline, drafting, fact-checking, art, audio, and a pushed review-ready branch.
Needs OPENAI_API_KEY · ELEVENLABS_API_KEY
View skill
General Writing
Rewrite or draft text in clear, natural language. Strips AI clichés, filler, and overly formal phrasing.
View skill
Blog Fact Check
Fact-check a post before publishing: verify every claim and external link against credible sources, and keep a persistent per-post report of findings and decisions.
View skill
Audio & video
Narration, teasers, and generated video for every post.
Blog Audio Script
Convert a blog post into a spoken-word narration script written for the ear: natural pacing, breath pauses, and no code read aloud.
View skill
Blog Audio Generate
Generate the post MP3 with ElevenLabs from an approved spoken script and flip hasAudio on automatically.
Needs ELEVENLABS_API_KEY · ELEVENLABS_VOICE_ID
View skill
Blog Social Teaser
Write a 20–45 second spoken teaser script for social video that hooks the topic and points people at the full post.
View skill
Blog Social Video
Generate a complete paper-cut-style social share video for a post: branded bumpers, ElevenLabs voice-over, and Veo b-roll via the Vercel AI Gateway.
Needs ELEVENLABS_API_KEY · AI_GATEWAY_API_KEY
View skill
Storyboard Video
Multi-scene paper-cut UI explainer pipeline: script, scene continuity locks, narration, storyboards, Veo clips, and final concat - with per-scene re-direction.
Needs ELEVENLABS_API_KEY · AI_GATEWAY_API_KEY
View skill
Video Generate Explainer
Gated Remotion pipeline for narrated UI/product explainers: real app UI rebuilt in code, human approval at every gate, cheap to revise as the product changes.
Needs ELEVENLABS_API_KEY · ELEVENLABS_VOICE_ID
View skill
Imagery
Background art and presentable screenshots.
BG Image
Generate square themed background art for public/bg with OpenAI image generation, matching the site's grain-texture visual language.
Needs OPENAI_API_KEY
View skill
Screenshot Image
Composite a raw screenshot onto a site background as a rounded, drop-shadowed card and save a web-optimised WebP to public/screenshots.
View skill
UI & UX
Design-concept feedback and page audits against UX laws and interface guidelines.
Quality & review
Checks that keep pages and code honest against the site's own standards — SEO, responsive layout, and SOLID architecture.
Responsive Layout Audit
Audit a page against a maintained responsive-design checklist: breakpoint behaviour, touch targets, and what stays visible on mobile vs. collapses into a menu or toggle.
View skill
SOLID
Apply or audit SOLID design principles (SRP, OCP, LSP, ISP, DIP) when architecting application code or reviewing a PR for blast-radius violations.
View skill
SEO
Review or improve a page's or post's SEO: metadata, canonical URLs, structured data (JSON-LD), sitemap/robots entries, heading structure, and image alt text.
View skill
Meta
Skills for writing and migrating skills, bundled with dot-skills.
Creating Skills
bundledHow to author a new dot-skills-compatible skill: naming, frontmatter schema, dependency declarations, and descriptions that actually trigger.
View skill
Importing Skills
bundledHow to migrate agent-native rules and skills (.cursorrules, .claude/skills, AGENTS.md sections, and friends) into the canonical .skills/ format.
View skill
Under the hood
One copy, every agent
Before dot-skills, this repo carried near-duplicate copies of each skill in .claude/skills/ and .agents/skills/, and they drifted apart. Now .skills/ holds the only real copy and every agent directory is a symlink, so an edit in one place lands everywhere at once.