skills.rest
shawn-sandy
shawn-sandyCOMMUNITY
Explore all skills by this author →
Website𝕏@shawnsandyGitHub

share-explanation

Explains project files and concepts, then generates social cards and platform-ready copy.

Updated Jun 8, 2026
Search Tags:#documentation#playwright#code explanation#screenshot#social card#social media copy#security scrub
One-click install
npx skills add https://github.com/shawn-sandy/agentics-kit --skill share-explanation-shawn-sandy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: share-explanation
Source: https://github.com/shawn-sandy/agentics-kit/tree/main/kit/plugins/social-media-tools/skills/share-explanation
Command: npx skills add https://github.com/shawn-sandy/agentics-kit --skill share-explanation-shawn-sandy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Answering "how does X work" questions about a codebase usually means manually reading source files, writing an explanation, and then separately drafting social posts and graphics to share it. This Skill automates that entire pipeline from source reading to a shareable PNG card. ## Core Features & Use Cases - Source-grounded explanations: Locates skills, commands, files, functions, or concepts via a five-tier lookup and synthesizes structured explanations from the actual code. - Security scrub gate: Runs every explanation through a security-scrub check before anything is shared, hard-stopping on blocked content. - Social card generation: Populates HTML templates, renders a PNG screenshot via Playwright, drafts platform-aware copy (LinkedIn, Twitter/X, Bluesky, Substack), and saves everything to docs/media/social/. - Use Case: Ask "how does the security-scrub skill work" and receive a structured explanation, ready-to-post social copy, and a branded PNG card saved to your project. ## Quick Start Ask the assistant to explain how a specific file, function, or skill in this project works and generate a shareable social card for it.

Frequently Asked Questions about share-explanation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a social media card explaining my code?▼

Ask how a file, function, or concept in your project works. The skill locates the source, synthesizes an explanation, populates an HTML template, and renders a PNG card via Playwright along with platform-ready copy.

What social platforms does the generated copy support?▼

Copy is drafted for LinkedIn, Twitter/X, Bluesky, and Substack, with per-platform character limits, tone defaults, and format rules. You can override the platform and tone with --platform and --tone flags.

Does it check for secrets before sharing code explanations?▼

Yes. Every explanation passes through a security-scrub gate before drafting or rendering. If the gate returns BLOCKED or CANCELLED, the workflow stops and nothing is shared or saved.

Where are the generated cards and posts saved?▼

Generated HTML cards, PNG screenshots, and drafted posts are saved persistently under docs/media/social/ in your project, with filenames derived from the target name and date. A reuse check avoids duplicating existing posts.

What happens if the target file or concept is not found?▼

The skill runs a five-tier lookup covering skills, commands, files, functions, and keyword grep. If nothing matches, it stops and suggests trying the exact file name, function name, or a key term from the code.

Related Skills

Explore More Content & Communication Skills→
acme-skunkworksacme-skunkworks

initialise-skills

Automate skill configuration reconciliation and generate machine-readable inventory from repository facts.

Official
Intermediate
ahmadawaisahmadawais
19

typefully

Draft, schedule, and publish social media posts across multiple platforms via Typefully API.

Community
Advanced
emliunixemliunix

privacy-review

Scan Git repositories for exposed secrets and sensitive data.

Community
Advanced
fatihkanfatihkan
7

content

Generate SEO-friendly blog posts, articles, and marketing content from topic, audience, and keywords.

Community
Advanced