zyjst
c7d87bd1f3
- skill-authoring §2.4: Folder vs name rules (Components/Pages/Strategies may differ; Channels/Platforms/Analytics = match) - github-seo -> github: multi-use platform for SEO, GEO, parasite SEO, open source - open-source-strategy: new skill (strategies/commercial/open-source) - channels: folder=name (affiliate-marketing, referral-program, public-relations, etc.) - strategies/paid-ads/analytics: restructured into subfolders - DevHunt in directory-submission; CHANGELOG updated Made-with: Cursor
13 KiB
Installation & Use Cases
Skills are markdown instruction files. They work anywhere an AI can read text — IDEs, vibe-coding tools, chat models, and any platform with file access. This doc covers platforms, installation, use cases, and content roadmap.
Reference: Agent Skills spec · skills.sh (40+ agents) · agentskills.help
0. Agent Skills Overview
What they are: Agent Skills are a lightweight, open format for extending AI agents with procedural knowledge — the "how to" steps and rules, not static descriptions. Think of them as "skill packs" or "plugins": authors write once; agents load on demand when the task matches. They solve the context gap — packaging organizational knowledge, team workflows, and domain norms into reusable Markdown that agents read at the right moment for more consistent, auditable behavior.
How they differ: Prompt is one-off, per conversation. Skill is reusable, version-controlled, loaded when needed. Tool is a single executable (API call, file write). MCP connects agents to external services. RAG retrieves docs to augment context but doesn't execute. Skills complement all of these.
Discovering skills: Browse skills.sh (All Time, Trending, Hot); search with npx skills find [keyword]; or npx skills add owner/repo --list to see a repo's skills. Check skills.sh/kostja94 for this repo's listing.
SkillsBench tip (for reference only — one paper's findings): 2–3 relevant skills per task may be a performance sweet spot; 4+ skills can cause context overload. Prefer selective install (--skill a b c) when you know the task. See skill-authoring §9.
Quick Summary
| Platform Type | Platforms | How |
|---|---|---|
| Native Skills | Cursor, Claude Code, Codex, OpenCode, Gemini CLI, GitHub Copilot, Windsurf, Cline, Base44, Trae | npx skills add kostja94/marketing-skills or copy to .agents/skills/ |
| AGENTS.md | Lovable, Replit | OpenSkills sync or .lovable/skills/ + adapt paths |
| Paste / Reference | v0, Bolt.new, Medo, ChatGPT, Gemini, Claude Web | Paste skill markdown as context, or copy to project root |
| CLI Multi-Platform | AMP, KiloCode, Roo, Goose, Kiro, OpenClaw | npx skills add ... -a <platform> |
1. Platforms with Native Agent Skills Support
These platforms auto-discover skills from standard directories. Install once, agent loads on demand.
Platform Table
| Platform | Project Dir | User Dir | Notes |
|---|---|---|---|
| Cursor | .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/ |
~/.cursor/skills/, ~/.claude/skills/, ~/.codex/skills/ |
Cursor docs |
| Claude Code | .claude/skills/, .agents/skills/ |
~/.claude/skills/, ~/.agents/skills/ |
Claude Code docs |
| Codex | .agents/skills/ |
~/.agents/skills/, /etc/codex/skills |
OpenAI Codex docs |
| OpenCode | .opencode/skills/, .agents/skills/, .claude/skills/ |
~/.config/opencode/skills/, ~/.agents/skills/, ~/.claude/skills/ |
OpenCode docs |
| Gemini CLI | .gemini/skills/, .agents/skills/ |
~/.gemini/skills/, ~/.agents/skills/ |
Gemini CLI docs |
| GitHub Copilot | .github/skills/, .claude/skills/, .agents/skills/ |
~/.copilot/skills/, ~/.claude/skills/ |
GitHub Copilot docs |
| Windsurf | .windsurf/skills/ |
~/.codeium/windsurf/skills/ |
Windsurf docs |
| Cline | .cline/skills/ |
~/.cline/skills/ |
Cline docs |
| Base44 | .cursor/skills/, .claude/skills/, .agents/skills/ |
— | Base44 docs |
| Trae | .cursor/skills/, .claude/skills/, .agents/skills/ |
— | Trae docs |
Universal path: .agents/skills/ works on Cursor, Claude Code, Codex, OpenCode, Gemini CLI, and GitHub Copilot.
Install Command
# Install to default platform
npx skills add kostja94/marketing-skills
# Install to multiple platforms
npx skills add kostja94/marketing-skills -a cursor -a claude-code -a codex -a opencode
Syncing with GitHub
To keep skills updated: CLI — re-run npx skills add kostja94/marketing-skills (overwrites); Git submodule — git submodule add https://github.com/kostja94/marketing-skills.git .cursor/marketing-skills, then cp -r .cursor/marketing-skills/skills/* .cursor/skills/; update with cd .cursor/marketing-skills && git pull.
2. OpenClaw
OpenClaw is an open-source personal AI assistant. It uses AgentSkills-compatible skill folders — the same SKILL.md format as this repo.
Skill locations (precedence)
| Location | Scope |
|---|---|
./skills (workspace) |
Per-agent; highest priority |
~/.openclaw/skills/ |
Shared across all agents |
| Bundled skills | Shipped with OpenClaw (lowest) |
Install
# Install all marketing skills to OpenClaw
npx skills add kostja94/marketing-skills -a openclaw
# Install specific skills only
npx skills add kostja94/marketing-skills -a openclaw --skill robots-txt title-tag meta-description pricing-page-generator
Product context: Add project-context.md to your OpenClaw workspace. Skills read it automatically. See README § Project Context.
3. Other Platforms (skills.sh CLI)
| Platform | Config Path | Docs |
|---|---|---|
| AMP | ~/.config/agents/skills/ |
AMP docs |
| KiloCode | ~/.kilocode/skills/ |
Kilo docs |
| Roo | ~/.roo/skills/ |
Roo docs |
| Goose | ~/.config/goose/skills/ |
Goose docs |
| Kiro | ~/.kiro/skills/ |
Kiro docs |
| OpenClaw | ./skills or ~/.openclaw/skills/ |
OpenClaw Skills docs |
4. Vibe Coding / No-Code Platforms
| Platform | How to Use | Docs |
|---|---|---|
| Lovable | AGENTS.md in project root; OpenSkills (openskills sync); or copy to .lovable/skills/ and adapt paths |
Lovable docs |
| Replit | Same as Lovable. OpenSkills can sync skills to AGENTS.md | Replit docs |
| v0 (Vercel) | Uses CLAUDE.md. Copy skills to project root or paste in prompts |
Vercel v0 |
| Bolt.new | Browser-based; no project file structure. Paste skill markdown as context | Bolt.new |
| Medo | Paste skill content into dialogue | medo.dev |
Approach: Create a product-specific directory (e.g. .lovable/); copy project-context.md and fill it in; copy skill files from skills/*/SKILL.md; adapt path references (e.g. .cursor/project-context.md → .lovable/project-context.md).
5. ChatGPT, Gemini, Claude Web
Skills are plain markdown. Use them with any LLM that accepts text input.
- Open a skill file (e.g. skills/seo/on-page/metadata/SKILL.md).
- Copy the full content.
- In ChatGPT, Gemini, Claude, or similar: paste the skill as context, then ask your question.
Example prompt: Paste title-tag or meta-description skill content, then: "Using these guidelines, optimize the meta title and description for my homepage. Product: [brief description]. Target keyword: [keyword]."
Tips: Paste project-context before the skill for tailored output; paste most relevant sections if token limits apply.
6. Path Reference Cheat Sheet
| Original | Replace with |
|---|---|
.cursor/project-context.md |
.lovable/project-context.md (or your path) |
.claude/project-context.md |
Same as above |
.cursor/project-task-tracker.md |
.lovable/project-task-tracker.md (optional) |
.cursor/skills/ |
.agents/skills/, .claude/skills/, ./skills (OpenClaw), ~/.openclaw/skills/, or platform-specific dir |
7. Use Cases
7.1 Personal Developer — SEO-Friendly Personal Site
Scenario: Individual developers want to build a personal website (portfolio, blog, landing page) with SEO built in.
Why this works: One-click install; no need to learn SEO from scratch — the agent applies best practices when you ask.
Recommended skills subset: Technical: robots-txt, xml-sitemap, canonical-tag, indexing; On-page: title-tag, meta-description, open-graph, twitter-cards, schema-markup, heading-structure; Pages: homepage-generator, about-page-generator, contact-page-generator, blog-page-generator; Components: hero-generator, footer-generator, cta-generator.
7.2 Product Website — SEO Growth with Frontend + Ops Split
Scenario: A product website wants to drive SEO growth. Frontend uses optimization techniques; operations can build marketing pages independently via rewrite without depending on engineering.
Recommended skills subset: Technical + on-page (frontend team); Pages (marketing): pricing-page-generator, landing-page-generator, use-cases-page-generator, customer-stories-page-generator, alternatives-page-generator, integrations-page-generator; Strategies: seo-strategy, paid-ads-strategy, website-structure.
7.3 Vibe Coding Beginner — Learn SEO Standalone
Scenario: Someone new to vibe coding (Bolt.new, v0, Lovable, etc.) wants to learn SEO and website construction.
Why this works: Skills are markdown — install and read them as learning material. Use ChatGPT, Claude Web, or Gemini: paste a skill, ask questions, get explanations.
Recommended approach: Start with seo-strategy for workflow overview; then technical: robots-txt, xml-sitemap, title-tag, meta-description; use skill-authoring and skills-reference §2 for structure.
7.4 Vibe Coding Product — Built-in Skills as Templates
Scenario: Vibe coding platforms want to ship SEO-friendly outputs by default. Built-in skills act as templates so user-generated projects are more discoverable.
Partnership: If you build a vibe coding product and want to integrate these skills, contact me for collaboration.
7.5 Want to Build Your Own Skills — Fork & Adapt
Scenario: You want to create your own agent skills but don't know where to start.
Why this works: Fork the repo — you get 100+ working examples to modify and adapt. Learn from structure — SKILL.md format, frontmatter, Related Skills, output patterns are all documented.
How to start:
- Fork kostja94/marketing-skills
- Read skill-authoring for format and authoring rules
- Pick a skill similar to what you want (e.g.
pricing-page-generator→ yourcustom-page-generator) - Copy, rename, edit — then install with
npx skills add your-username/your-fork
7.6 Future — Non-Website Agents
| Agent Type | Relevant Skills Today | Future Expansion |
|---|---|---|
| Image / Video | — | New skills: image generation prompts, video script/storyboard |
| Marketing (Influencer) | influencer-marketing, creator-program, twitter-x-posts, tiktok-captions, linkedin-posts |
Campaign briefs, creator discovery criteria |
| Marketing (Ads) | paid-ads-strategy |
Ad copy, landing page alignment, ROAS optimization |
| Analytics | analytics-tracking, google-search-console, ai-traffic-tracking, traffic-analysis |
Dashboard design, report templates |
| Content | keyword-research, content-strategy, content-optimization |
Editorial workflows, content repurposing |
8. Content Roadmap
Content creation recommendations based on existing skills and market trends:
- Personal Site Quick Start: Minimal skill subset (10–15 skills); one-command install; order of operations
- Product Website SEO Playbook: Frontend vs ops ownership; rewrite rules for marketing pages; page priority
- Vibe Coding SEO Learning Path: Week 1–4 structure; which skill to use; example prompts
- Vibe Coding Integration Guide: How to bundle skills; AGENTS.md integration; partnership CTA
- Non-Website Agent Roadmap: Proposed new skills; multi-agent reuse structure
- Skill Authoring from Fork: Step-by-step fork → copy → edit → publish
9. Partnership
If you are building:
- A vibe coding product and want SEO-friendly defaults
- An AI marketing agent (influencer, ads, content)
- A learning platform for SEO or website building
Reach out: zyjstc@gmail.com