description-scripting

A skill for AI coding agents (Claude Code, OpenCode, Cowork, or Claude.ai) that writes promotional copy/descriptions for websites whose source code is sold as a digital product.

Built for developers, freelancers, or small agencies who build websites (landing pages, dashboards, starter kits, etc.) and want to resell the source code as a digital product — across social media and marketplaces.

What this skill does

Once triggered, the AI agent will:

1. Gather the key details about the website being promoted (website type, tech stack, standout features, use case, price)
2. Ask which platform(s) the copy is for, if not already specified
3. Write copy that is short, specific, and to the point — matching the format and conventions of each platform
4. Always sell the source code itself, never the product/service displayed inside the website

Supported platforms:

Category	Platforms
Social Media	Instagram Feed, Instagram Reel (+ video script), Facebook Post, Threads, TikTok Description, LinkedIn Article (+ title)
Digital Product Marketplaces	Gumroad, Envato/ThemeForest, Lynk.id, plus a generic format for other marketplaces

Output language follows the user's instructions/context at the time (Indonesian, English, or mixed) — it isn't locked to a single language.

Structure

description-scripting/
├── README.md
├── SKILL.md                     # Entry point: workflow & copywriting principles
└── references/
    ├── social-media.md          # Templates for IG Feed, IG Reel, FB, Threads, TikTok, LinkedIn
    └── marketplace.md           # Templates for Gumroad, Envato/ThemeForest, Lynk.id

Installation

OpenCode

1. Download description-scripting'.skill from Releases (or the dist/ folder in this repo), or clone this repo directly.
2. Extract/place the description-scripting'/ folder into your OpenCode skills directory.
3. Make sure SKILL.md keeps its name and description frontmatter (included by default).

Claude Code

git clone https://github.com/<username>/description-scripting.git
cp -r description-scripting ~/.claude/skills/

Claude.ai / Cowork

Upload the .skill file (a zip of this skill folder) as a custom skill via the skill settings menu.

If you have package_skill.py from skill-creator or a similar tool, you can generate your own .skill file with:

python -m scripts.package_skill path/to/description-scripting

Example usage

Write an Instagram Feed caption for the SaaS landing page I built with Next.js,
featuring a dashboard, auth, and dark mode. Priced at $29.

Please write a LinkedIn title + article and an Envato listing for the
Laravel-based e-commerce template I just finished.

Give me 3 versions of a Threads caption with different angles for the
portfolio website source code I'm selling on Gumroad.

The skill triggers automatically on requests like "write a sales description", "caption to promote this website", "listing to sell this", or whenever a specific platform is mentioned (Instagram, LinkedIn, Gumroad, etc.).

Customization

This skill is designed to be general-purpose across website types (landing pages, SaaS, e-commerce, portfolios, etc.). To tailor it to a specific niche, you can:

• Edit references/social-media.md or references/marketplace.md to add or change platform templates
• Add a new reference file (e.g. references/email-marketing.md) and point to it from SKILL.md if you want to support an additional promotion channel
• Adjust the "Copywriting principles" section in SKILL.md to match your brand's tone

Contributing

Pull requests are welcome for:

• New platform templates (e.g. Pinterest, X/Twitter, Reddit)
• Improvements or additional examples in references/
• Better triggering descriptions in the SKILL.md frontmatter

License

MIT — free to use, modify, and redistribute.