Skip to content
Back to search

ai-agents-skills

SkillWorks with Claude CodeGitHub

🧠 AI Agent Skills Repository - A curated collection of specialized skills for AI coding agents (Claude Code, GitHub Copilot, Cursor, Windsurf). Created by Yuval Avidani using GitHub Copilot via VS Code Insiders.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hoodini-ai-agents-skills/badge.svg)](/listings/hoodini-ai-agents-skills)

HTML

<a href="/listings/hoodini-ai-agents-skills"><img src="/api/listings/hoodini-ai-agents-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

curl -sSL https://raw.githubusercontent.com/hoodini/ai-agents-skills/master/install.sh | bash

Installs **16 skills** as one package: **director** (award-winning film + AI-production Bible, story-first workflow) Β· **yuv-pilot** (top-of-pyramid orchestrator) Β· **yuv-design-system** (brand) Β· **yuv-decks** (cinematic presentations) Β· **yuv-viral-video** (short-form) Β· **video-edit** Β· **video-to-landing-page** Β· **parallax-landing-page** Β· **hyperframes** + 4 companions Β· **nano-banana-pro** (AI images) Β· **mermaid-diagrams**. Plus ffmpeg / Node / Python / faster-whisper / hyperframes CLI / Python venvs / cross-tool symlinks to ~/.copilot/skills + ~/.agents/skills. Works on macOS, Linux, Windows (Git Bash/WSL).

After install, restart your agent and just type what you want:

"make a deck about <topic> for <audience>"
"build a stunning parallax landing page from this video: <path>"
"edit this video into a viral short: <path>"

The right skill auto-fires. Projects save to **`~/Documents/yuv-projects/{decks,landings,videos}/<slug>/`** so they're always findable.

> 🌐 **Live examples:** [yuv.ai](https://yuv.ai) · [effects.yuv.ai](https://effects.yuv.ai) (HyperFrames effects catalog) · [examples/parasites/](examples/parasites/) (three parallax landings: GitHub Desktop, Marcus the lion, Hope the cheetah)

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md Β· README Β· 986 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="https://img.shields.io/badge/AI-Agent%20Skills-blueviolet?style=for-the-badge&logo=robot&logoColor=white" alt="AI Agent Skills"/>
  3. <img src="https://img.shields.io/badge/GitHub-Star-yellow?style=for-the-badge&logo=github&logoColor=white" alt="GitHub Star"/>
  4. <img src="https://img.shields.io/badge/AWS-GenAI%20Superstar-orange?style=for-the-badge&logo=amazonaws&logoColor=white" alt="AWS GenAI Superstar"/>
  5. </p>
  6. <p align="center">
  7. <img src="hero-skills.jpg" alt="AI Agent Skills Hero"/>
  8. </p>
  9. <h1 align="center">🧠 Agent Skills Repository</h1>
  10. <p align="center">
  11. <strong>Created by <a href="https://yuv.ai">Yuval Avidani</a></strong> Β· <em>AI Builder, Speaker, 2Γ— GitHub Star, AWS GenAI Superstar, AI commentator on Channel 12 News (Israel)</em><br/>
  12. <a href="https://yuv.ai">yuv.ai</a> Β· <a href="https://linktr.ee/yuvai">all links</a> Β· <a href="https://x.com/yuvalav">@yuvalav</a> Β· <a href="https://instagram.com/yuval_770">@yuval_770</a> Β· <a href="https://youtube.com/@yuv-ai">YouTube</a> Β· <a href="https://github.com/hoodini">GitHub</a>
  13. </p>
  14. ---
  15. ## ⚑ Install the full creative stack in one command
  16. ```bash
  17. curl -sSL https://raw.githubusercontent.com/hoodini/ai-agents-skills/master/install.sh | bash
  18. ```
  19. Installs **16 skills** as one package: **director** (award-winning film + AI-production Bible, story-first workflow) Β· **yuv-pilot** (top-of-pyramid orchestrator) Β· **yuv-design-system** (brand) Β· **yuv-decks** (cinematic presentations) Β· **yuv-viral-video** (short-form) Β· **video-edit** Β· **video-to-landing-page** Β· **parallax-landing-page** Β· **hyperframes** + 4 companions Β· **nano-banana-pro** (AI images) Β· **mermaid-diagrams**. Plus ffmpeg / Node / Python / faster-whisper / hyperframes CLI / Python venvs / cross-tool symlinks to ~/.copilot/skills + ~/.agents/skills. Works on macOS, Linux, Windows (Git Bash/WSL).
  20. After install, restart your agent and just type what you want:
  21. ```
  22. "make a deck about <topic> for <audience>"
  23. "build a stunning parallax landing page from this video: <path>"
  24. "edit this video into a viral short: <path>"
  25. ```
  26. The right skill auto-fires. Projects save to **`~/Documents/yuv-projects/{decks,landings,videos}/<slug>/`** so they're always findable.
  27. > 🌐 **Live examples:** [yuv.ai](https://yuv.ai) · [effects.yuv.ai](https://effects.yuv.ai) (HyperFrames effects catalog) · [examples/parasites/](examples/parasites/) (three parallax landings: GitHub Desktop, Marcus the lion, Hope the cheetah)
  28. ---
  29. ## πŸͺœ The YUV.AI skills pyramid
  30. The YUV.AI creative stack is a **three-tier pyramid**. You don't have to remember which skill does what β€” say what you want, the orchestrator routes.
  31. ```
  32. β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
  33. β”‚ yuv-pilot β”‚ ← top: intent β†’ route
  34. β”‚ (orchestrator) β”‚
  35. β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
  36. β”‚
  37. β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
  38. β–Ό β–Ό β–Ό
  39. β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
  40. β”‚yuv-decksβ”‚ β”‚ yuv-design- β”‚ β”‚ yuv-viral- β”‚
  41. β”‚ β”‚ β”‚ system β”‚ β”‚ video β”‚
  42. β”‚ talks Β· β”‚ β”‚ β”‚ β”‚ β”‚
  43. β”‚ slides Β·β”‚ β”‚ palette Β· β”‚ β”‚ short MP4s Β· β”‚
  44. β”‚ keynotesβ”‚ β”‚ typography Β·β”‚ β”‚ Reels Β· TikTokβ”‚
  45. β”‚ β”‚ β”‚ 3 modes Β· β”‚ β”‚ MrBeast-paced β”‚
  46. β”‚ β”‚ β”‚ assets β”‚ β”‚ editorial β”‚
  47. β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
  48. β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
  49. β”‚ video-edit β”‚ β”‚ parallax- β”‚ β”‚ video-to- β”‚
  50. β”‚ β”‚ β”‚ landing-page β”‚ β”‚ landing-page β”‚
  51. β”‚ captioned Β· β”‚ β”‚ β”‚ β”‚ β”‚
  52. β”‚ Hebrew+EN Β· β”‚ β”‚ scroll-scrub Β· β”‚ β”‚ Apple-style Β· β”‚
  53. β”‚ transcript- β”‚ β”‚ video frames Β· β”‚ β”‚ sticky hero Β· β”‚
  54. β”‚ review flow β”‚ β”‚ github/lion/hopeβ”‚ β”‚ frames + sectionsβ”‚
  55. β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
  56. β”‚
  57. β–Ό (the middle tier uses these)
  58. open-slide Β· hyperframes Β· gsap Β· nano-banana-pro Β· video-use Β·
  59. slide-authoring Β· mermaid-diagrams Β· hyperframes-cli Β· website-to-hyperframes
  60. Brand DNA β€” universal Fly High throughline:
  61. flight metaphors Β· HUD + dials Β· phoenix mark Β·
  62. "Let's Fly High" watermark Β· Anton + JetBrains Mono
  63. (palette is the chapter, motifs are the brand)
  64. ```
  65. ### How to invoke
  66. | Say | What fires |
  67. |---|---|
  68. | `"build me a deck about <topic> for <audience>"` | `yuv-decks` (lead) + `yuv-design-system` in **Decks mode** + `open-slide` scaffolding |
  69. | `"build a landing page for me / my brand"` | `yuv-design-system` in **Neon mode** + `gsap` for motion |
  70. | `"turn this video into a landing page"` *(5–15s clip)* | `parallax-landing-page` β€” scroll-scrub cinematic landing |
  71. | `"turn this video into a landing page"` *(longer, with sections)* | `video-to-landing-page` β€” Apple-style sticky-hero |
  72. | `"edit this video / add captions"` | `video-edit` β€” transcript-review-before-render workflow |
  73. | `"make it viral / YUV.AI short"` | `yuv-viral-video` β€” opinionated MrBeast-paced pipeline |
  74. | `"launch my new course / cross-channel campaign"` | `yuv-pilot` β€” orchestrates a build order across multiple skills |
  75. | `"what should I build for my brand"` *(strategic, no specific deliverable)* | `yuv-pilot` β€” surfaces options |
  76. | `"build me a snake game"` *(no YUV.AI signal)* | **Whole pyramid stays out** β€” picks whatever palette fits |
  77. | `"build me a YUV.AI snake game"` *(explicit brand signal)* | `yuv-design-system` in **Neon mode** + Three.js or Canvas |
  78. ### Three palette modes (only when applied)
  79. | Mode | When | Palette |
  80. |---|---|---|
  81. | **Neon** *(default for YUV.AI web/app/game/dashboard/social)* | Anything that's not a slide deck | Hot pink `#FF1464` + neon cyan `#00E5FF` + white or rich black |
  82. | **Decks** *(Fly High)* | Presentations, slides, keynotes only | Purple `#5E17EB` + yellow `#FFEC00` + grey `#F1F2F2` |
  83. | **Warm Editorial** | Hope, Marcus, bigcats.ai, practical.yuv.ai | Pink + yellow + bone |
  84. The pyramid auto-applies **only** when YUV.AI brand context is signaled (`my brand`, `for me`, `YUV.AI`, etc.). Generic requests stay outside the system β€” Claude / Copilot / Cursor pick whatever fits the project.
  85. ---
  86. ## πŸ†• NEW: cinematic-scrub-landing β€” golden landing page template
  87. Drop in a hero video + logo + product photo. Get back a **premium cinematic landing page** with mouse-driven video scrubbing and a 5-beat narrative arc.
  88. <p align="center">
  89. <img src="skills/cinematic-scrub-landing/assets/01-hero-mouse-scrub.png" alt="Mouse-scrub hero" width="640"/>
  90. </p>
  91. The hero video lives fixed across the whole page β€” moving the mouse left-right scrubs the timeline so the subject responds to the cursor. Below it, **four fully-opaque sections each carry their own brand identity** (bright primary-accent recipe / cream nostalgia album / dark contemplative pricing / red action finale) and walk the viewer through *longing β†’ joy β†’ nostalgia β†’ contemplation β†’ action*. Works for **any language** (RTL or LTR) and **any subject** β€” food, tech, animals, fashion, services, SaaS, wildlife, music, books, real estate.
  92. <p align="center">
  93. <img src="skills/cinematic-scrub-landing/assets/02-yellow-recipe.png" alt="Bright primary section" width="220"/>
  94. <img src="skills/cinematic-scrub-landing/assets/03-cream-album.png" alt="Cream album section" width="220"/>
  95. <img src="skills/cinematic-scrub-landing/assets/04-dark-pricing.png" alt="Dark pricing section" width="220"/>
  96. <img src="skills/cinematic-scrub-landing/assets/05-red-cta.png" alt="Red CTA finale" width="220"/>
  97. </p>
  98. **What's baked in (every rule hard-won from a real production build):**
  99. - **All-keyframes ffmpeg re-encode** (`-g 1 -keyint_min 1`) so mouse-scrub is buttery, not stuttery
  100. - **The z-index trap** documented as hard rule #1 (outer wrapper has NO bg class, or the video disappears)
  101. - **Per-section opaque identities** β€” no monotone scrim through every section
  102. - **Language-aware typography trinity** (Hebrew Rubik+Assistant+Suez One / English Anton+Inter+Caveat / Arabic Cairo+Tajawal+Reem Kufi / Japanese Noto Sans JP / etc.)
  103. - **RTL/LTR mirroring** β€” hero panel side, cursor cue side, scroll-to-top position, arrow direction
  104. - **Six reusable visual primitives** β€” polaroid, stamp, ribbon, highlight-circle, ghost-text, motif SVGs
  105. - **Real product photography wins over generated gradients** β€” the skill always finds prominent placement for `PRODUCT_IMAGE`
  106. - **Clickable scroll-spy navbar** + scroll-to-top button + favicon set from the logo
  107. - **12-step verification gate** before reporting done
  108. Reference implementation: <https://github.com/hoodini/bamba> (Israeli RTL site for the snack "Χ‘ΧžΧ‘Χ”" β€” the original build this skill was distilled from).
  109. πŸ”— **[View cinematic-scrub-landing β†’](skills/cinematic-scrub-landing/SKILL.md)**
  110. Pairs with `parallax-landing-page` (scroll-scrub frames, page never moves) and `video-to-landing-page` (Apple-style sticky hero with sections below) β€” pick `cinematic-scrub-landing` when the hero should respond to the **cursor** and the page below should **tell a story**.
  111. ---
  112. ## yuv-design-system has moved
  113. The YUV.AI design system is now **Phoenix Sky v4.1** and lives in a private repo (`hoodini/yuv-design-system`), installed from there. The old public copy (Fly High purple/yellow, Warm Editorial, PurpleBar, FlightHUD) is retired; [`skills/yuv-design-system`](skills/yuv-design-system/SKILL.md) is now only a pointer, and `install.sh` no longer installs it, so it can never overwrite the current system.
  114. ---
  115. ## πŸ†• NEW: yuv-decks β€” opinionated cinematic deck builder
  116. Builds open-slide presentation decks in Yuval Avidani's signature style: 4-act narrative arc (Boarding β†’ Ascent β†’ Cruise β†’ Descent), Yuval voice (plain-language, no jargon, ≀8–12 word bullets, define every name), the flight-themed `JourneyBar` unifying every slide, reusable `UseCase` / `CaseStudy` / `LessonsGrid` templates, and an automatic orchestration of nano-banana cinematic hero images + Hyperframes video moments + Mermaid technical diagrams.
  117. Inherits all palette/typography/components from `yuv-design-system` and locks the **Decks mode** (Fly High purple/yellow/grey β€” the dedicated palette for slides). For talks whose central metaphor IS literal flight, opt into the `cinematic-flight` mode (sky-blue + hot pink) β€” same arc and JourneyBar, different palette. Never falls through to Neon (web/app palette).
  118. πŸ”— **[View yuv-decks β†’](skills/yuv-decks/SKILL.md)**
  119. Reference implementation: <https://github.com/hoodini/build-agents-that-ship> (the NICE pre-hackathon "Build Agents That Ship" deck, May 2026).
  120. ---
  121. ## πŸ†• NEW: Parallax Landing Page Skill
  122. Turn any short video (5–15s) into a **cinematic scroll-driven landing page** where the
  123. user's scroll gesture *scrubs the frames in place* β€” the page itself never scrolls. A single
  124. locked viewport with five dramatic text scenes that crossfade in/out as the frame index
  125. advances, an Anton + Caveat typography contract, off-white #f5f1ea (never pure white), a
  126. vignette + film-grain overlay, a loader that preloads every frame, and a final scene that
  127. holds the CTAs (no separate end section). Built on the proven `parasites/` reference repo
  128. (GitHub Desktop / Marcus the white lion / Hope the cheetah landings).
  129. πŸ”— **[View the Parallax Landing Page Skill β†’](skills/parallax-landing-page/SKILL.md)**
  130. **What's inside:**
  131. - `scripts/extract_frames.py` β€” ffprobe + ffmpeg `-q:v 2` extraction with auto-computed `scrollBudget` (β‰ˆ26 px per frame, clamped to `[2500, 8000]`)
  132. - `assets/parallax.js` β€” virtual-scroll controller: wheel/touch/keyboard intercepted, document never moves, RAF-driven lerp (0.22) for buttery frame scrubbing
  133. - `assets/style.css` β€” locked-body landing page CSS (`body.scrub-page`), 5-scene grid, vignette + grain, Anton/Caveat/Inter font stack
  134. - `assets/landing-page-template.html` β€” full template with `{{placeholders}}` for slug, scenes, CTAs
  135. - `assets/hub-template.html` β€” 3-up showcase grid template for multi-landing projects
  136. - `references/copy-guide.md` β€” the five-beat arc (Hook β†’ Origin β†’ Stakes β†’ Moment β†’ Resolution) with three real cinematic examples
  137. - `references/showcase-integration.md` β€” exact edits to grow an existing hub (card + nav + chain CTA)
  138. **One-shot:** point the script at a video, capture the JSON, fill in the template, serve with `python -m http.server`.
  139. ```bash
  140. python skills/parallax-landing-page/scripts/extract_frames.py demo.mp4 ./out/demo
  141. ```
  142. 🎬 **See it live:** the three landing pages built with this skill ship in
  143. [`examples/parasites/`](examples/parasites/) β€” GitHub Desktop, Marcus the white lion,
  144. and Hope the cheetah. After cloning:
  145. ```bash
  146. cd examples/parasites && python -m http.server 8000
  147. # open http://localhost:8000/
  148. ```
  149. > Note: distinct from `video-to-landing-page` (which uses an evenly-spaced
  150. > scroll-listener approach). This skill is the "Apple AirPods Pro" variant β€” every frame,
  151. > locked body, dramatic typography, narrative beats.
  152. ---
  153. ## πŸ†• NEW: Video-Edit Skill (with Interactive Transcript Editor)
  154. A complete captioned-video pipeline that **pauses for human transcript approval** before the
  155. long final render β€” the support mechanism that makes captions perfect (especially Hebrew).
  156. Transcribes any video with `faster-whisper` (defaults to `large-v3`), applies a configurable
  157. corrections dictionary, opens an **interactive browser editor** with video preview, per-line
  158. inline editing, dictionary apply, find/replace and **optional in-browser LLM suggestions via
  159. WebLLM** (Qwen2.5-3B / Llama-3.2-3B over WebGPU β€” runs entirely offline once cached). On
  160. approval, redistributes word timings and generates a HyperFrames composition with
  161. liquid-glass caption pills, drifting blob background, liquid morph wipes, and optional
  162. behind-subject text via background removal. Supports English, Hebrew and any
  163. Whisper-supported language.
  164. πŸ”— **[View the Video-Edit Skill β†’](skills/video-edit/SKILL.md)**
  165. **What's inside:**
  166. - `transcribe.py` β€” faster-whisper CPU/CUDA with safe fallback
  167. - `make_review.py` + `apply_review.py` β€” emit & ingest a `transcript_review.txt` round-trip
  168. - `transcript-editor/index.html` β€” self-contained webapp (RTL-aware, autosaves to localStorage)
  169. - `gen_body.py` β€” generator for editorial + matrix liquid-glass caption sub-composition
  170. - `host-template.html` + `liquid-blobs.html` + EN/HE parallax-outro templates
  171. - `corrections-hebrew.md` β€” curated dictionary of common Hebrew Whisper mishears
  172. ---
  173. ## πŸ†• NEW: Video-to-Landing-Page Skill
  174. Drop a video, get a cinematic **scroll-driven landing page** β€” Apple-style sticky hero where
  175. scrolling progresses the visible frame through the video. Extracts evenly-spaced frames via
  176. ffmpeg, builds a self-contained `index.html` with a `requestAnimationFrame`-driven scroll
  177. listener, and includes headline / sections / CTA below. Respects the `yuv-design-system` typography
  178. (Anton + Inter for English, Rubik + Assistant for Hebrew) and Fly High purple palette by default.
  179. πŸ”— **[View the Video-to-Landing-Page Skill β†’](skills/video-to-landing-page/SKILL.md)**
  180. **One command from video to deployable page:**
  181. ```bash
  182. python skills/video-to-landing-page/references/extract-frames.py demo.mp4 ./landing-demo --build-html
  183. ```
  184. Then customise `__HEADLINE__`, `__TAGLINE__`, `__CTA_TEXT__` in the generated `index.html`
  185. and drop the folder on Vercel / Netlify / Cloudflare Pages.
  186. ---
  187. ## πŸš€ NEW: Yuv-Viral-Video Skill
  188. **Just added!** The complete signature-style video editor that turns raw selfie or screen-share footage into a viral short-form video the way YUV.AI ships them β€” Apple-style liquid-glass cards with real backdrop blur, dark-mode polish, MrBeast-paced cuts, video-title karaoke captions, content-relevant motion graphics, no fake content, **never covering the speaker's face**, always rendering BOTH 9:16 and 16:9, always saving with `_V<N>` backup suffix. Hebrew is rendered in Rubik Black (with proper RTL via `python-bidi`), English in Anton uppercase. Encodes every painful lesson from real edits as a hard rule the next render automatically respects.
  189. πŸ”— **[View the Yuv-Viral-Video Skill β†’](skills/yuv-viral-video/SKILL.md)**
  190. **What it does:**
  191. - Apple-style frosted glass cards: rounded corners + `gblur sigma=24` backdrop + `alphamerge` masks so the blur stops cleanly at the rounded shape (no rectangular leak past the corners)
  192. - Auto-routes the layout per archetype: screen-share footage shows the screen content (top 2/3) with rounded speaker PIP at bottom 1/3; full-frame selfie shows the speaker prominently with cards in the safe top-banner zone (face never covered)
  193. - Per-segment dynamic motion (push-in / pull-out / snap-in / dolly / shake) baked into the extract chain with subtle MrBeast-style amounts
  194. - Real animated diagrams: bar chart (uses actual category names from transcript, never fake numbers), flow diagram with glowing brand-color nodes connected by animated dashed arrows
  195. - Word-by-word video-title karaoke: scale-pop entrance with `\fscx150\fscy150\t(0,140,\fscx100\fscy100)`, accent words get yellow + rotation jitter, English brand tokens auto-route to Anton uppercase
  196. - Bottom key-moment glass strips that summarise the current beat in 1-4 words (Hebrew right + English left + yellow accent stripe)
  197. - ElevenLabs SFX kit (impact, bass_drop, whoosh, riser, ding, glitch, typing) mixed at the right output times via `adelay`
  198. - Two-pass loudnorm to -14 LUFS / -1 dBTP / LRA 11 (TikTok / Reels / YouTube standard)
  199. - **Versioning**: every render writes a NEW `final_*_V<N>.mp4` β€” previous versions are never overwritten
  200. - **Truth contract**: every word on every card is auditable against the actual transcript. No "$$$" placeholders, no "100% Χ”Χ‘Χ Χ”" if the speaker didn't say it, no "ΧœΧ™Χ Χ§ Χ‘Χ‘Χ™Χ•" if no link was promised
  201. ---
  202. ## πŸ†• NEW: Meta Ads Skill
  203. **Just added!** A battle-tested skill for pulling, analyzing, and managing Meta ad performance (Facebook, Instagram, Messenger, Click-to-WhatsApp, Threads) via the Marketing API. No guesswork, no generic dashboards β€” the scripts auto-discover your accounts, decode status codes and currency units, handle rate limits and async insights jobs, and guard write actions behind explicit confirmations.
  204. πŸ”— **[View the Meta Ads Skill β†’](skills/meta-ads/SKILL.md)**
  205. **What it does:**
  206. - Pulls ad-level, ad-set-level, campaign-level, and account-level insights with full breakdowns (platform, placement, age, gender, country, device)
  207. - Auto-discovers every ad account your token can see, ranked by last-30-day spend β€” so you never paste the wrong `act_` ID
  208. - Handles both auth paths out of the box: System User tokens (never expire, BM-owned accounts) and long-lived user tokens (60-day, sees personal Instagram-boost accounts)
  209. - Ships a token-exchange script for the short→60-day swap — no more fumbling through Graph Explorer docs
  210. - Creative fatigue detection, anomaly detection vs. prior period, CTWA-aware analysis playbooks
  211. - Write actions (pause, budget update, duplicate) gated behind explicit confirmation with impact summaries and rollback patterns
  212. - Baked-in troubleshooting for every failure mode we hit the hard way: sandbox proxy blocks, 37-month data wall, DELETED-status error 1815001, minor-unit currency bugs, IG boosts invisible to SU tokens, and more
  213. - **NEW: works as your PPC operator, not just a reporter.** An end-to-end loop for selling: map the funnel, install and verify the Meta Pixel on every page (including third-party checkouts, with a real test purchase), launch a Sales campaign that can actually learn, read it stage by stage, fix leaks live, build stage-by-stage remarketing, and monitor daily
  214. - `funnel_report.py` (funnel by stage with leak rates, breakdowns by placement/age/hour) and `check_pixel.py` (catches missing pixels, leftover pixels, and the ad-account-ID-pasted-as-pixel mistake)
  215. - `create_campaign.py` now runs existing Instagram posts as ads, CBO, pixel-event optimization and placement presets, validates everything with Meta before creating, refuses accounts without a payment method, and can resume a half-built run
  216. - **NEW: real sales from the course platform.** Connects to the Schooler MCP (or any checkout platform) to reconcile Meta's attributed purchases with actual enrollments, and turns the data into the cheapest sales you have: people who signed up but didn't pay, past buyers of one course who don't own the next, and students who paid but never started (`segment_students.py`)
  217. - **NEW: runs in Grok Bot too.** `sh scripts/install-grok-bot.sh --skill meta-ads` installs it into a bot's skill library; a dedicated analyst bot runs the daily check as a routine and alerts you on Telegram/WhatsApp, while every change still waits for your approval
  218. - Hard-won traps documented: Audience Network eating conversion budgets, Advantage+ age stretch, reporting lag, IG posts turning into zero-like ad copies, boost pickers that hide ad-account-owned pixels, deprecated creative enhancements
  219. ---
  220. ## πŸ†• NEW: Google Workspace CLI Skill
  221. **Just added!** A comprehensive skill that teaches AI agents to use the `gws` CLI β€” one command-line tool for **all** of Google Workspace: Drive, Gmail, Calendar, Sheets, Docs, Slides, Chat, Tasks, Admin, Meet, Forms, Keep, and more. Your agent can now manage your entire Google Workspace without custom tooling.
  222. πŸ”— **[View the Google Workspace CLI Skill β†’](skills/google-workspace-cli/SKILL.md)**
  223. **What it does:**
  224. - Enables AI agents to interact with every Google Workspace API via `gws` CLI commands
  225. - Covers Drive, Gmail, Calendar, Sheets, Docs, Slides, Chat, Tasks, Meet, Forms, Admin, Keep, Apps Script, and more
  226. - Includes 100+ ready-to-use command examples with real JSON payloads
  227. - MCP server integration for Claude Desktop, VS Code, Gemini CLI, and other MCP clients
  228. - Multiple auth workflows: interactive, headless/CI, service accounts, and multi-account support
  229. - Built on Google's Discovery Service β€” automatically picks up new API endpoints
  230. ---
  231. ## 🧠 Honest Agent Skill
  232. A universal skill that configures ALL your AI coding agents to be honest, objective, and non-sycophantic. Run it once, and every agent (Claude Code, GitHub Copilot, Cursor, Windsurf, etc.) will stop telling you what you want to hear and start giving you honest, direct feedback.
  233. πŸ”— **[View the Honest Agent Skill β†’](skills/honest-agent/SKILL.md)**
  234. **What it does:**
  235. - Configures honest, objective communication across 7 verified AI coding agents
  236. - One-time setup that updates all your agent instruction files
  237. - Supports both project-level and global configuration
  238. - Works with Claude Code, Copilot, Cursor, Windsurf, Cline, Aider, and Continue.dev
  239. ---
  240. <p align="center">
  241. <strong>A curated collection of AI agent skills for enhanced coding assistance</strong>
  242. </p>
  243. <p align="center">
  244. <em>Supercharge your AI coding agents with specialized knowledge and production-ready patterns</em>
  245. </p>
  246. <p align="center">
  247. <a href="#-available-skills">Skills</a> β€’
  248. <a href="#-quick-start">Quick Start</a> β€’
  249. <a href="#-usage">Usage</a> β€’
  250. <a href="#-contributing">Contributing</a>
  251. </p>
  252. ---
  253. ## πŸ‘‹ About Yuval Avidani
  254. <table>
  255. <tr>
  256. <td width="180" valign="top">
  257. <a href="https://yuv.ai"><img src="https://github.com/hoodini.png?size=180" width="180" alt="Yuval Avidani"/></a>
  258. </td>
  259. <td valign="top">
  260. ### **Yuval Avidani** β€” *AI Builder & Speaker Β· Founder of YUV.AI*
  261. **πŸ† 2Γ— GitHub Star** Β· **🌟 AWS Gen AI Superstar** Β· **πŸ“Ί AI commentator on Channel 12 News (Israel)** Β· **🎀 Enterprise AI Trainer**
  262. > Founder of **YUV.AI** β€” leading Hebrew-speaking AI educator and technical innovator. Builds, teaches, and ships AI that actually works. Open-source maintainer of 110+ projects spanning AI agents, video pipelines, design systems, and developer tools.
  263. **Hebrew bio:** *Χ™Χ•Χ‘Χœ אבידני β€” ΧžΧ’Χ™Χ© Χ€Χ™Χ Χͺ AI Χ‘Χ—Χ“Χ©Χ•Χͺ 12, GitHub Star Χ›Χ€Χ•Χœ, AWS Gen AI Superstar, ΧžΧ™Χ™Χ‘Χ“ YUV.AI. Χ‘Χ•Χ Χ”, ΧžΧœΧžΧ“, Χ•ΧžΧ©Χ’Χ¨ AI Χ©Χ’Χ•Χ‘Χ“.*
  264. </td>
  265. </tr>
  266. </table>
  267. ### πŸ”— Find me everywhere
  268. <p>
  269. <a href="https://yuv.ai"><img src="https://img.shields.io/badge/yuv.ai-website-5E17EB?style=for-the-badge&logo=safari&logoColor=FFEC00" /></a>
  270. <a href="https://linktr.ee/yuvai"><img src="https://img.shields.io/badge/Linktree-all_links-39E09B?style=for-the-badge&logo=linktree&logoColor=white" /></a>
  271. <a href="https://x.com/yuvalav"><img src="https://img.shields.io/badge/X-@yuvalav-000000?style=for-the-badge&logo=x&logoColor=white" /></a>
  272. <a href="https://instagram.com/yuval_770"><img src="https://img.shields.io/badge/Instagram-@yuval__770-E4405F?style=for-the-badge&logo=instagram&logoColor=white" /></a>
  273. <a href="https://www.tiktok.com/@yuval.ai"><img src="https://img.shields.io/badge/TikTok-@yuval.ai-000000?style=for-the-badge&logo=tiktok&logoColor=white" /></a>
  274. <a href="https://youtube.com/@yuv-ai"><img src="https://img.shields.io/badge/YouTube-@yuv--ai-FF0000?style=for-the-badge&logo=youtube&logoColor=white" /></a>
  275. <a href="https://github.com/hoodini"><img src="https://img.shields.io/badge/GitHub-@hoodini-181717?style=for-the-badge&logo=github&logoColor=white" /></a>
  276. <a href="https://www.linkedin.com/in/yuval-avidani-87081474/"><img src="https://img.shields.io/badge/LinkedIn-Yuval_Avidani-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white" /></a>
  277. <a href="https://facebook.com/yuval.avidani"><img src="https://img.shields.io/badge/Facebook-Yuval_Avidani-1877F2?style=for-the-badge&logo=facebook&logoColor=white" /></a>
  278. </p>
  279. ### πŸ’Ό Work with me
  280. - **πŸŽ“ Practical Claude Desktop course** β†’ <https://practical.yuv.ai>
  281. - **πŸš€ Enterprise AI training & speaking** β†’ DM on [LinkedIn](https://www.linkedin.com/in/yuval-avidani-87081474/) or [@yuvalav](https://x.com/yuvalav)
  282. - **🀝 Built something with this stack?** Tag [@yuvalav](https://x.com/yuvalav) on X or DM [@yuval_770](https://instagram.com/yuval_770) on Instagram β€” I'll feature the best work
  283. - **⭐ Star this repo** if it saves you time β€” helps other builders find it
  284. ---
  285. ## ✨ What Are Agent Skills?
  286. Agent skills are **specialized knowledge modules** that enhance AI coding agents with domain-specific expertise. They provide:
  287. - 🎯 **Focused Knowledge** β€” Only what the AI doesn't already know
  288. - πŸ“ **Production-Ready Code** β€” Working examples, not abstract concepts
  289. - ⚑ **Quick Activation** β€” Trigger keywords for instant context
  290. - πŸ”„ **Reusable Patterns** β€” Copy once, use everywhere
  291. ---
  292. ## �️ Understanding Agent Skills (Open Standard)
  293. ### What is SKILL.md?
  294. **SKILL.md** is a simple, open format for giving AI agents new capabilities and expertise. It's an open standard that works across multiple AI coding agents and platforms.
  295. > **Agent Skills** are folders of instructions, scripts, and resources that your AI agent can discover and use to perform tasks more accurately and efficiently.
  296. ### Why Use Agent Skills?
  297. **For You (Developer)**:
  298. - πŸ“š **Learn Faster** β€” Pre-built knowledge from experts in your domain
  299. - 🎯 **Better Results** β€” Agents have context to work more accurately
  300. - ♻️ **Reuse Everywhere** β€” Same skill works across Copilot, Claude Code, Cursor, Windsurf, and more
  301. - πŸ” **Version Control** β€” Skills are part of your repository, tracked in git
  302. **For Your Team**:
  303. - πŸ“– **Capture Knowledge** β€” Document processes and best practices
  304. - πŸš€ **Share Skills** β€” Distribute expertise across projects
  305. - 🏒 **Enterprise Use** β€” Centralize organizational knowledge
  306. **For AI Agents**:
  307. - 🧠 **Domain Expertise** β€” Perform specialized tasks reliably
  308. - πŸ”§ **New Capabilities** β€” Enable new workflows and automations
  309. - πŸŽ“ **Context** β€” Access procedures, scripts, and examples on demand
  310. ### What Can You Do With Agent Skills?
  311. Agent skills enable AI agents to:
  312. - **Domain Expertise**: Package specialized knowledge (legal review, data analysis, deployment procedures)
  313. - **New Capabilities**: Create presentations, build MCP servers, analyze datasets, debug failures
  314. - **Repeatable Workflows**: Turn multi-step tasks into consistent, auditable processes
  315. - **Interoperability**: Reuse skills across different compatible agent products
  316. ---
  317. ## πŸ“š How Agent Skills Work (Step-by-Step for Beginners)
  318. ### Step 1: Understanding the File Structure
  319. Each skill is a simple folder with a `SKILL.md` file inside:
  320. ```
  321. your-project/
  322. β”œβ”€β”€ .github/skills/ # GitHub Copilot project skills location
  323. β”‚ └── my-skill-name/
  324. β”‚ β”œβ”€β”€ SKILL.md # Main skill file (required)
  325. β”‚ β”œβ”€β”€ script.js # Optional: supporting scripts
  326. β”‚ └── examples.md # Optional: more examples
  327. β”œβ”€β”€ .claude/skills/ # Claude Code project skills location
  328. β”‚ └── my-skill-name/
  329. β”‚ └── SKILL.md
  330. └── ~/.copilot/skills/ # Personal skills (available across all projects)
  331. └── my-skill-name/
  332. └── SKILL.md
  333. ```
  334. ### Step 2: Understanding SKILL.md Format
  335. Every `SKILL.md` file has two parts:
  336. **YAML Frontmatter** (metadata):
  337. ```yaml
  338. ---
  339. name: my-skill-name # Unique identifier (lowercase, hyphens for spaces)
  340. description: What this skill # When should the agent use this skill?
  341. license: MIT # Optional: license information
  342. ---
  343. ```
  344. **Markdown Body** (instructions):
  345. The rest of the file contains instructions and examples for the AI agent.
  346. ### Step 3: A Real Example
  347. Here's what a simple `SKILL.md` looks like:
  348. ```markdown
  349. ---
  350. name: github-actions-debugging
  351. description: Guide for debugging failing GitHub Actions workflows. Use this when asked to debug CI/CD failures or workflow issues.
  352. ---
  353. # Debugging GitHub Actions Workflows
  354. When debugging a failing workflow:
  355. 1. **Check the job logs** - Look for error messages and stack traces
  356. 2. **Review recent changes** - What changed since the last successful run?
  357. 3. **Test locally** - Reproduce the issue in your local environment
  358. 4. **Fix and validate** - Make changes and verify they work
  359. ## Common Issues and Solutions
  360. ### Issue: Workflow fails with "Command not found"
  361. **Solution**: Install the required tool in your workflow step
  362. ### Issue: Permission denied when running scripts
  363. **Solution**: Add `chmod +x script.sh` before running the script
  364. ```
  365. ### Step 4: Agent Discovers and Uses Your Skill
  366. When you ask your AI agent to do something:
  367. ```
  368. "Debug why our GitHub Actions workflow is failing"
  369. ```
  370. The agent will:
  371. 1. βœ… **Recognize** that you're asking about GitHub Actions
  372. 2. βœ… **Find** the `github-actions-debugging` skill in your project
  373. 3. βœ… **Load** the `SKILL.md` file into its context
  374. 4. βœ… **Follow** the instructions to help you debug
  375. ### Step 5: Supported Locations
  376. **Project Skills** (specific to one repository):
  377. - `your-repo/.github/skills/` β€” For GitHub Copilot
  378. - `your-repo/.claude/skills/` β€” For Claude Code
  379. **Personal Skills** (available across all projects on your machine):
  380. - `~/.copilot/skills/` β€” For GitHub Copilot (Copilot CLI and VS Code)
  381. - `~/.claude/skills/` β€” For Claude Code
  382. **Organization/Enterprise Skills** (coming soon):
  383. - Enterprise-level skills support is in development
  384. ---
  385. ## 🀝 Supported AI Agents
  386. Agent Skills work with these AI coding agents:
  387. | Agent | Support | Location |
  388. |:------|:--------|:---------|
  389. | **GitHub Copilot** | βœ… Full Support | `.github/skills/` or `~/.copilot/skills/` |
  390. | **Claude Code** | βœ… Full Support | `.claude/skills/` or `~/.claude/skills/` |
  391. | **Cursor** | βœ… Full Support | `.cursor/rules/` |
  392. | **Windsurf** | βœ… Full Support | `.windsurf/rules/` |
  393. | **VS Code Insiders** | βœ… Full Support | Agent mode with skills |
  394. | **VS Code (Stable)** | ⏳ Coming Soon | Support coming in future release |
  395. ---
  396. ## πŸ“¦ Available Skills
  397. | Skill | Description | Keywords |
  398. |:------|:------------|:---------|
  399. | **[aws-harness](skills/aws-harness/SKILL.md)** πŸ†• | Build a new agent AND deploy it easily on AWS, or wrap + ship an agent you already have, via the Bedrock AgentCore harness - CLI (create/dev/deploy/invoke) plus SDK-wrap and FastAPI/Docker/ECR paths, every import verified | `agent harness`, `AWS harness`, `AgentCore`, `agentcore create`, `agentcore deploy`, `deploy agent on AWS`, `bring your own agent` |
  400. | **[director](skills/director/SKILL.md)** πŸ†• | Award-winning director's brain β€” a 28-chapter film + AI-production Bible (~108k words) wrapped in a gated, interrogation-first workflow that locks the IDEA and SCRIPT before generating a single pixel, then plans shots/camera/light/sound, then generates. Honest neuroscience (no dopamine-as-pleasure myths), current AI image/video model selection, character-consistency SOP, first/last-frame keyframing | `director`, `video`, `film`, `teaser`, `trailer`, `storyboard`, `script`, `screenwriting`, `documentary`, `Χ‘Χ¨Χ˜Χ•ΧŸ`, `Χ˜Χ™Χ–Χ¨`, `ΧͺΧ‘Χ¨Χ™Χ˜`, `Χ‘Χ˜Χ•Χ¨Χ™Χ‘Χ•Χ¨Χ“` |
  401. | **[yuv-design-system](skills/yuv-design-system/SKILL.md)** | Moved to a private repo (Phoenix Sky v4.1). This folder is a pointer only; the old Fly High system is retired | `design system`, `brand`, `Fly High`, `Warm Editorial`, `Anton`, `Rubik`, `PurpleBar`, `YellowUnderline`, `FlightHUD`, `yuv.ai` |
  402. | **[yuv-decks](skills/yuv-decks/SKILL.md)** πŸ†• | Open-slide cinematic deck builder β€” 4-act narrative arc, Yuval voice, JourneyBar, reusable templates, automatic nano-banana + Hyperframes orchestration | `deck`, `presentation`, `slides`, `talk`, `keynote`, `open-slide`, `cinematic deck`, `ΧžΧ¦Χ’Χͺ`, `שק׀ים` |
  403. | **[yuv-viral-video](skills/yuv-viral-video/SKILL.md)** | Short-form video editor β€” liquid-glass cards, dark-mode, MrBeast-paced cuts, karaoke captions, ALWAYS 9:16 + 16:9, never covers the speaker's face | `viral video`, `reel`, `short`, `selfie edit`, `liquid glass`, `karaoke captions`, `Χ•Χ™Χ¨ΧΧœΧ™`, `Χ¨Χ™Χœ` |
  404. | **[parallax-landing-page](skills/parallax-landing-page/SKILL.md)** πŸ†• | Cinematic scroll-scrub landing page from a short video β€” locked body, virtual scroll, 5 crossfading scenes, Anton + Caveat typography | `parallax landing`, `scroll-scrub`, `frame-by-frame`, `Anton`, `Caveat`, `locked hero`, `virtual scroll`, `video to landing page` |
  405. | **[video-edit](skills/video-edit/SKILL.md)** πŸ†• | Captioned-video pipeline with interactive transcript editor + WebLLM suggestions before render | `video edit`, `captions`, `transcribe`, `Hebrew`, `WebLLM`, `liquid-glass captions`, `HyperFrames` |
  406. | **[video-to-landing-page](skills/video-to-landing-page/SKILL.md)** πŸ†• | Apple-style scroll-driven landing page from any video β€” frames scrub on scroll | `landing page from video`, `scroll-frame`, `Apple scroll`, `scrub on scroll` |
  407. | **[meta-ads](skills/meta-ads/SKILL.md)** πŸ†• | Meta Ads as a PPC operator: pixel setup and verification, Sales campaigns, funnel diagnosis, live optimization, stage-by-stage remarketing, daily monitoring | `Meta ads`, `Facebook ads`, `Instagram ads`, `Meta Pixel`, `Sales campaign`, `remarketing`, `ROAS`, `CPA`, `CTWA`, `creative fatigue` |
  408. | **[google-workspace-cli](skills/google-workspace-cli/SKILL.md)** πŸ†• | Google Workspace CLI (`gws`) β€” Drive, Gmail, Calendar, Sheets, Docs, Chat & more | `gws`, `Google Workspace`, `Google Drive`, `Gmail`, `Google Calendar`, `Google Sheets`, `MCP` |
  409. | **[copilot-sdk](skills/copilot-sdk/SKILL.md)** | GitHub Copilot SDK for building agentic applications | `Copilot SDK`, `GitHub SDK`, `agentic app`, `embed Copilot` |
  410. | **[honest-agent](skills/honest-agent/SKILL.md)** πŸ†• | Configure all AI agents for honest, objective feedback | `honest agent`, `no sycophancy`, `objective`, `contradict me` |
  411. | **[aws-strands](skills/aws-strands/SKILL.md)** | The agent framework (the "brain") - write agent logic, tools & multi-agent systems; deploy via aws-harness | `Strands`, `agent framework`, `agents as tools`, `Swarm`, `Graph`, `BedrockModel` |
  412. | **[aws-account-management](skills/aws-account-management/SKILL.md)** | AWS Organizations, IAM, billing & multi-account | `AWS Organizations`, `IAM`, `SCPs`, `Cost Explorer` |
  413. | **[langchain](skills/langchain/SKILL.md)** | LangChain/LangGraph pipelines and agent workflows | `LangChain`, `LangGraph`, `RAG`, `LCEL` |
  414. | **[vercel](skills/vercel/SKILL.md)** | Vercel deployment, serverless, and edge functions | `Vercel`, `serverless`, `edge function` |
  415. | **[railway](skills/railway/SKILL.md)** | Railway platform deployment and configuration | `Railway`, `deploy container` |
  416. | **[cloudflare](skills/cloudflare/SKILL.md)** | Cloudflare Workers, Pages, D1, R2, KV & AI | `Cloudflare`, `Workers`, `D1`, `R2`, `edge computing` |
  417. | **[figma](skills/figma/SKILL.md)** | Figma API, component code generation & design tokens | `Figma API`, `design tokens`, `Figma to code` |
  418. | **[fal-ai](skills/fal-ai/SKILL.md)** | Serverless AI image/video generation with fal.ai | `fal.ai`, `Flux`, `SDXL`, `AI image generation` |
  419. | **[mongodb](skills/mongodb/SKILL.md)** | MongoDB & Mongoose queries, aggregation pipelines | `MongoDB`, `Mongoose`, `aggregation`, `NoSQL` |
  420. | **[bun](skills/bun/SKILL.md)** | Bun JavaScript runtime, bundler & test runner | `Bun`, `bun.sh`, `JavaScript runtime` |
  421. | **[owasp-security](skills/owasp-security/SKILL.md)** | OWASP Top 10 security vulnerabilities & prevention | `OWASP`, `security`, `XSS`, `SQL injection`, `CSRF` |
  422. | **[shabbat-times](skills/shabbat-times/SKILL.md)** | Jewish calendar data and Shabbat times integration | `Shabbat times`, `Hebcal`, `Zmanim` |
  423. | **[copilot-docs](skills/copilot-docs/SKILL.md)** | GitHub Copilot custom instructions reference | `copilot-instructions.md` |
  424. | **[nano-banana-pro](skills/nano-banana-pro/SKILL.md)** | Google Gemini 3 Pro Image generation | `Nano Banana Pro`, `Gemini 3 Pro Image` |
  425. | **[github-trending](skills/github-trending/SKILL.md)** | GitHub trending repositories scraping | `GitHub trending`, `trending repos` |
  426. | **[ux-design-systems](skills/ux-design-systems/SKILL.md)** | Design systems and component libraries | `design system`, `design tokens`, `theming` |
  427. | **[web-accessibility](skills/web-accessibility/SKILL.md)** | WCAG compliance and accessibility patterns | `accessibility`, `a11y`, `WCAG`, `ARIA` |
  428. | **[mobile-responsiveness](skills/mobile-responsiveness/SKILL.md)** | Responsive design and mobile-first patterns | `responsive`, `mobile-first`, `breakpoints` |
  429. | **[analytics-metrics](skills/analytics-metrics/SKILL.md)** | Data visualization and analytics dashboards | `analytics`, `dashboard`, `charts`, `KPI` |
  430. | **[mermaid-diagrams](skills/mermaid-diagrams/SKILL.md)** | Mermaid diagram syntax for visualizations | `Mermaid`, `flowchart`, `sequence diagram` |
  431. | **[local-llm-router](skills/local-llm-router/SKILL.md)** | Route queries to local LLMs in air-gapped networks with Serena MCP | `local LLM`, `Ollama`, `LM Studio`, `air-gapped`, `Serena`, `model routing` |
  432. | **[x-twitter-scraper](skills/x-twitter-scraper/SKILL.md)** | X/Twitter data extraction β€” tweet search, user lookup, followers, media, monitoring | `Twitter`, `X`, `scraper`, `OSINT`, `tweets`, `followers` |
  433. ---
  434. ## πŸš€ Quick Start
  435. ### 1. Clone the Repository
  436. ```bash
  437. git clone https://github.com/yuval-avidani/ai-agents-skills.git
  438. ```
  439. ### 2. Copy Skills to Your Project
  440. Choose your AI coding agent and follow the instructions below.
  441. ---
  442. ## πŸ’» Setup Guide: Using Skills in Your Agent (For Beginners)
  443. This guide walks you through setting up Agent Skills in your favorite coding agent, step by step.
  444. ### 🎯 Prerequisites
  445. Before you start, you need:
  446. - A coding agent installed (Copilot, Claude Code, Cursor, or Windsurf)
  447. - A project folder on your computer
  448. - Basic familiarity with command line or your agent's UI
  449. ### πŸ“ Step-by-Step Setup
  450. #### **Option 1: GitHub Copilot** (Most Popular)
  451. <details>
  452. <summary><strong>🟒 Setup GitHub Copilot with Skills</strong></summary>
  453. **For Project Skills** (specific to one repository):
  454. 1. **In your project folder**, create the skills directory:
  455. ```bash
  456. mkdir -p .github/skills
  457. ```
  458. 2. **Copy the skills you want** from this repository:
  459. ```bash
  460. # Copy a single skill
  461. cp -r skills/vercel .github/skills/
  462. # Or copy all skills
  463. cp -r skills/* .github/skills/
  464. ```
  465. 3. **Or manually create a skill**:
  466. ```
  467. your-project/
  468. └── .github/
  469. └── skills/
  470. └── my-custom-skill/
  471. └── SKILL.md
  472. ```
  473. 4. **Open your project in VS Code** and start using Copilot Agent
  474. 5. **Ask Copilot a question** related to your skill, and it will automatically load it!
  475. **For Personal Skills** (available across all your projects):
  476. 1. **Find your home directory** (`~` or `C:\Users\YourUsername`)
  477. 2. **Create personal skills folder**:
  478. ```bash
  479. mkdir -p ~/.copilot/skills
  480. ```
  481. 3. **Copy skills there**:
  482. ```bash
  483. cp -r skills/vercel ~/.copilot/skills/
  484. ```
  485. 4. **Now all your projects** can use these skills automatically!
  486. **Verify it's working:**
  487. - Open Copilot Agent
  488. - Ask about something covered in your skill (e.g., "How do I deploy to Vercel?")
  489. - Copilot will use the skill to help you
  490. </details>
  491. ---
  492. #### **Option 2: Claude Code**
  493. <details>
  494. <summary><strong>🟣 Setup Claude Code with Skills</strong></summary>
  495. **For Project Skills**:
  496. 1. **In your project folder**, create the skills directory:
  497. ```bash
  498. mkdir -p .claude/skills
  499. ```
  500. 2. **Copy the skills you want**:
  501. ```bash
  502. # Single skill
  503. cp -r skills/langchain .claude/skills/
  504. # All skills
  505. cp -r skills/* .claude/skills/
  506. ```
  507. 3. **Open your project in Claude Code**
  508. 4. **Chat with Claude** about tasks covered in your skills - it will automatically use them!
  509. **For Personal Skills** (available everywhere):
  510. 1. **Create personal skills folder**:
  511. ```bash
  512. mkdir -p ~/.claude/skills
  513. ```
  514. 2. **Copy skills there**:
  515. ```bash
  516. cp -r skills/aws-harness ~/.claude/skills/
  517. ```
  518. **Verify it's working:**
  519. - Open Claude Code in your project
  520. - Ask about something in your skill
  521. - Claude will reference and use the skill
  522. </details>
  523. ---
  524. #### **Option 3: Cursor**
  525. <details>
  526. <summary><strong>πŸ”΅ Setup Cursor with Skills</strong></summary>
  527. **For Project Rules**:
  528. 1. **In your project folder**:
  529. ```bash
  530. mkdir -p .cursor/rules
  531. ```
  532. 2. **Copy SKILL.md files** (rename them as rules):
  533. ```bash
  534. # Copy a skill as a rule file
  535. cp skills/figma/SKILL.md .cursor/rules/figma.md
  536. # Or copy multiple
  537. cp skills/*/SKILL.md .cursor/rules/
  538. ```
  539. 3. **In Cursor Settings**, configure which rules to use:
  540. - Settings β†’ Rules β†’ Add project rules
  541. - Point to `.cursor/rules/` folder
  542. 4. **Start using Cursor** - it will apply these rules to your context automatically
  543. </details>
  544. ---
  545. #### **Option 4: Windsurf**
  546. <details>
  547. <summary><strong>🟑 Setup Windsurf with Skills</strong></summary>
  548. **For Project Rules**:
  549. 1. **In your project folder**:
  550. ```bash
  551. mkdir -p .windsurf/rules
  552. ```
  553. 2. **Copy skills as rules**:
  554. ```bash
  555. # Copy specific skills
  556. cp skills/vercel/SKILL.md .windsurf/rules/vercel.md
  557. # Or copy all skills
  558. cp skills/*/SKILL.md .windsurf/rules/
  559. ```
  560. 3. **Windsurf automatically** discovers rules in `.windsurf/rules/`
  561. 4. **Start building** - Windsurf will use these rules contextually
  562. </details>
  563. ---
  564. ### πŸŽ“ What Happens After Setup?
  565. Once you've set up your skills:
  566. 1. **Agent Detects Skills**: Your AI agent scans the skill directories
  567. 2. **Agent Reads SKILL.md**: It reads the name and description from frontmatter
  568. 3. **Agent Activates on Relevance**: When you ask a question matching the description, the agent loads the skill
  569. 4. **Agent Follows Instructions**: Your agent now has the context to help you accurately
  570. ### πŸ’‘ Example: Using a Vercel Skill
  571. **You have this SKILL.md**:
  572. ```yaml
  573. ---
  574. name: vercel-deployment
  575. description: Deploying applications to Vercel. Use this when asked about deploying, hosting, or managing Vercel projects.
  576. ---
  577. ```
  578. **You ask your agent**:
  579. > "Help me deploy my React app to Vercel"
  580. **Agent automatically**:
  581. - βœ… Finds `vercel-deployment` skill
  582. - βœ… Loads SKILL.md into context
  583. - βœ… Follows the deployment instructions
  584. - βœ… Helps you deploy successfully!
  585. ### πŸ› Troubleshooting
  586. | Problem | Solution |
  587. |:--------|:---------|
  588. | Agent not using skill | Restart your agent, or make sure folder path is correct |
  589. | Skill file not found | Verify `SKILL.md` is in the right folder and named exactly "SKILL.md" |
  590. | Agent using wrong skill | Make sure skill descriptions are descriptive enough to match your request |
  591. ---
  592. ## πŸ’» Usage (Advanced)
  593. ---
  594. ## πŸ“ Skill Format
  595. Each skill follows a consistent structure:
  596. ```markdown
  597. ---
  598. name: skill-name
  599. description: Brief description with trigger keywords
  600. ---
  601. # Skill Title
  602. Quick start and core patterns...
  603. ```
  604. ### 🎯 Key Principles
  605. | Principle | Description |
  606. |:----------|:------------|
  607. | **Concise is key** | Only include what the AI doesn't already know |
  608. | **Progressive disclosure** | Start with quick start, then advanced patterns |
  609. | **Concrete examples** | Working code over abstract descriptions |
  610. | **Trigger keywords** | Include words that activate the skill |
  611. ---
  612. ## πŸ“ Repository Structure
  613. ```
  614. ai-agents-skills/
  615. β”œβ”€β”€ πŸ“„ README.md
  616. β”œβ”€β”€ πŸ“ skills/
  617. β”‚ β”œβ”€β”€ πŸ“ meta-ads/ # πŸ†• NEW!
  618. β”‚ β”‚ β”œβ”€β”€ πŸ“„ SKILL.md
  619. β”‚ β”‚ β”œβ”€β”€ πŸ“„ requirements.txt
  620. β”‚ β”‚ β”œβ”€β”€ πŸ“ assets/
  621. β”‚ β”‚ β”‚ └── πŸ“„ env.template
  622. β”‚ β”‚ β”œβ”€β”€ πŸ“ references/
  623. β”‚ β”‚ β”‚ β”œβ”€β”€ πŸ“„ setup.md
  624. β”‚ β”‚ β”‚ β”œβ”€β”€ πŸ“„ insights-fields.md
  625. β”‚ β”‚ β”‚ β”œβ”€β”€ πŸ“„ analysis-playbooks.md
  626. β”‚ β”‚ β”‚ β”œβ”€β”€ πŸ“„ write-actions.md
  627. β”‚ β”‚ β”‚ └── πŸ“„ troubleshooting.md
  628. β”‚ β”‚ └── πŸ“ scripts/
  629. β”‚ β”‚ β”œβ”€β”€ πŸ“„ meta_client.py
  630. β”‚ β”‚ β”œβ”€β”€ πŸ“„ auth_check.py
  631. β”‚ β”‚ β”œβ”€β”€ πŸ“„ exchange_token.py
  632. β”‚ β”‚ β”œβ”€β”€ πŸ“„ list_accounts.py
  633. β”‚ β”‚ β”œβ”€β”€ πŸ“„ list_campaigns.py
  634. β”‚ β”‚ β”œβ”€β”€ πŸ“„ fetch_insights.py
  635. β”‚ β”‚ β”œβ”€β”€ πŸ“„ creative_fatigue.py
  636. β”‚ β”‚ β”œβ”€β”€ πŸ“„ anomaly_detect.py
  637. β”‚ β”‚ β”œβ”€β”€ πŸ“„ pause_ad.py
  638. β”‚ β”‚ β”œβ”€β”€ πŸ“„ update_budget.py
  639. β”‚ β”‚ └── πŸ“„ duplicate_ad.py
  640. β”‚ β”œβ”€β”€ πŸ“ google-workspace-cli/ # πŸ†• NEW!
  641. β”‚ β”‚ └── πŸ“„ SKILL.md
  642. β”‚ β”œβ”€β”€ πŸ“ copilot-sdk/
  643. β”‚ β”‚ └── πŸ“„ SKILL.md
  644. β”‚ β”œβ”€β”€ πŸ“ honest-agent/
  645. β”‚ β”‚ └── πŸ“„ SKILL.md
  646. β”‚ β”œβ”€β”€ πŸ“ aws-harness/ # πŸ†• NEW!
  647. β”‚ β”‚ └── πŸ“„ SKILL.md
  648. β”‚ β”œβ”€β”€ πŸ“ aws-strands/
  649. β”‚ β”‚ └── πŸ“„ SKILL.md
  650. β”‚ β”œβ”€β”€ πŸ“ aws-account-management/
  651. β”‚ β”‚ └── πŸ“„ SKILL.md
  652. β”‚ β”œβ”€β”€ πŸ“ langchain/
  653. β”‚ β”‚ └── πŸ“„ SKILL.md
  654. β”‚ β”œβ”€β”€ πŸ“ vercel/
  655. β”‚ β”‚ └── πŸ“„ SKILL.md
  656. β”‚ β”œβ”€β”€ πŸ“ railway/
  657. β”‚ β”‚ └── πŸ“„ SKILL.md
  658. β”‚ β”œβ”€β”€ πŸ“ cloudflare/
  659. β”‚ β”‚ └── πŸ“„ SKILL.md
  660. β”‚ β”œβ”€β”€ πŸ“ figma/
  661. β”‚ β”‚ └── πŸ“„ SKILL.md
  662. β”‚ β”œβ”€β”€ πŸ“ fal-ai/
  663. β”‚ β”‚ └── πŸ“„ SKILL.md
  664. β”‚ β”œβ”€β”€ πŸ“ mongodb/
  665. β”‚ β”‚ └── πŸ“„ SKILL.md
  666. β”‚ β”œβ”€β”€ πŸ“ bun/
  667. β”‚ β”‚ └── πŸ“„ SKILL.md
  668. β”‚ β”œβ”€β”€ πŸ“ owasp-security/
  669. β”‚ β”‚ └── πŸ“„ SKILL.md
  670. β”‚ β”œβ”€β”€ πŸ“ shabbat-times/
  671. β”‚ β”‚ └── πŸ“„ SKILL.md
  672. β”‚ β”œβ”€β”€ πŸ“ copilot-docs/
  673. β”‚ β”‚ └── πŸ“„ SKILL.md
  674. β”‚ β”œβ”€β”€ πŸ“ nano-banana-pro/
  675. β”‚ β”‚ └── πŸ“„ SKILL.md
  676. β”‚ β”œβ”€β”€ πŸ“ github-trending/
  677. β”‚ β”‚ └── πŸ“„ SKILL.md
  678. β”‚ β”œβ”€β”€ πŸ“ ux-design-systems/
  679. β”‚ β”‚ └── πŸ“„ SKILL.md
  680. β”‚ β”œβ”€β”€ πŸ“ web-accessibility/
  681. β”‚ β”‚ └── πŸ“„ SKILL.md
  682. β”‚ β”œβ”€β”€ πŸ“ mobile-responsiveness/
  683. β”‚ β”‚ └── πŸ“„ SKILL.md
  684. β”‚ β”œβ”€β”€ πŸ“ analytics-metrics/
  685. β”‚ β”‚ └── πŸ“„ SKILL.md
  686. β”‚ β”œβ”€β”€ πŸ“ mermaid-diagrams/
  687. β”‚ β”‚ └── πŸ“„ SKILL.md
  688. β”‚ β”œβ”€β”€ πŸ“ local-llm-router/
  689. β”‚ β”‚ β”œβ”€β”€ πŸ“„ SKILL.md
  690. β”‚ β”‚ └── πŸ“ references/
  691. β”‚ β”‚ └── πŸ“„ model-matrix.md
  692. β”‚ └── πŸ“ x-twitter-scraper/
  693. β”‚ └── πŸ“„ SKILL.md
  694. └── πŸ“ templates/
  695. └── πŸ“ skill-template/
  696. └── πŸ“„ SKILL.md
  697. ```
  698. ---
  699. ## 🀝 Contributing
  700. We welcome contributions! Here's how to add a new skill:
  701. 1. **Fork** this repository
  702. 2. **Create** a new skill in `skills/your-skill-name/SKILL.md`
  703. 3. **Follow** the [skill template](templates/skill-template/SKILL.md)
  704. 4. **Submit** a pull request
  705. ### Contribution Guidelines
  706. - βœ… Include practical, production-ready code examples
  707. - βœ… Add trigger keywords in the description
  708. - βœ… Test all code snippets before submitting
  709. - βœ… Keep explanations concise but complete
  710. - ❌ Don't include basic concepts the AI already knows
  711. - ❌ Don't use placeholder code or TODOs
  712. ---
  713. ## 🌟 Star History
  714. If you find this repository useful, please consider giving it a ⭐!
  715. ---
  716. ## πŸ“„ License
  717. MIT License β€” Feel free to use, modify, and distribute.
  718. ---
  719. <p align="center">
  720. <a href="https://yuv.ai"><img src="https://img.shields.io/badge/yuv.ai-5E17EB?style=flat-square&logo=safari&logoColor=FFEC00" /></a>
  721. <a href="https://linktr.ee/yuvai"><img src="https://img.shields.io/badge/Linktree-39E09B?style=flat-square&logo=linktree&logoColor=white" /></a>
  722. <a href="https://x.com/yuvalav"><img src="https://img.shields.io/badge/X-@yuvalav-000000?style=flat-square&logo=x&logoColor=white" /></a>
  723. <a href="https://instagram.com/yuval_770"><img src="https://img.shields.io/badge/IG-@yuval__770-E4405F?style=flat-square&logo=instagram&logoColor=white" /></a>
  724. <a href="https://www.tiktok.com/@yuval.ai"><img src="https://img.shields.io/badge/TikTok-@yuval.ai-000000?style=flat-square&logo=tiktok&logoColor=white" /></a>
  725. <a href="https://youtube.com/@yuv-ai"><img src="https://img.shields.io/badge/YouTube-@yuv--ai-FF0000?style=flat-square&logo=youtube&logoColor=white" /></a>
  726. <a href="https://github.com/hoodini"><img src="https://img.shields.io/badge/GitHub-@hoodini-181717?style=flat-square&logo=github&logoColor=white" /></a>
  727. <a href="https://www.linkedin.com/in/yuval-avidani-87081474/"><img src="https://img.shields.io/badge/LinkedIn-0A66C2?style=flat-square&logo=linkedin&logoColor=white" /></a>
  728. <a href="https://facebook.com/yuval.avidani"><img src="https://img.shields.io/badge/Facebook-1877F2?style=flat-square&logo=facebook&logoColor=white" /></a>
  729. </p>
  730. <p align="center">
  731. <strong>Made with ❀️ by <a href="https://yuv.ai">Yuval Avidani</a> · YUV.AI</strong><br/>
  732. <em>Building AI agents that ship Β· Let's Fly High πŸš€</em>
  733. </p>
  734. <p align="center">
  735. <a href="https://github.com/hoodini/ai-agents-skills">
  736. <img src="https://img.shields.io/github/stars/hoodini/ai-agents-skills?style=social" alt="Star this repo"/>
  737. </a>
  738. <a href="https://github.com/hoodini">
  739. <img src="https://img.shields.io/badge/Follow-@hoodini-181717?style=social&logo=github" alt="Follow on GitHub"/>
  740. </a>
  741. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.