samanhappy/skills

Latest recorded source activity: October 7, 2026 at 10:13

SkillsMP catalog refreshed: October 26, 2026 at 11:37

skills collected: 7

GitHub stars: 0
GitHub forks: 0

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/samanhappy/skills.

Repository README

Repository README source: README.md

Read the source README

Expand full README

# Saman's Skills [![skills.sh](https://skills.sh/b/samanhappy/skills)](https://skills.sh/samanhappy/skills) Personal agent skills I use to build real software with discipline, feedback loops, and a healthy respect for tests. I’m [Saman](https://github.com/samanhappy) — a software engineer based in Nanjing, China, with 15+ years of experience building backend systems, AI infrastructure, and developer tools. I build in public at [samanhappy.com](https://samanhappy.com/) and care a lot about craftsmanship over cargo-cult speed. This repository is where I collect the skills I actually want my coding agents to use. The goal is simple: keep them practical, composable, and grounded in real engineering work. Current skills: - **[github-maintainer](./skills/engineering/github-maintainer/SKILL.md)** — Advance GitHub issues, PRs, security, and quality asynchronously with gh, subagents, and maintainer approval gates. - **[verified-dev](./skills/engineering/verified-dev/SKILL.md)** — Disciplined, verification-driven development with a Red → Green → Refactor loop and visual proof. - **[optimize-prompt](./skills/engineering/optimize-prompt/SKILL.md)** — Diagnose and optimize agent prompts via decision-chain analysis and invariant fixes. - **[clip-subtitle-video](./skills/media/clip-subtitle-video/SKILL.md)** — Clip videos and burn bilingual subtitles into MP4 deliverables. - **[clean-paper-scan](./skills/documents/clean-paper-scan/SKILL.md)** — Turn phone photos of paper documents into clean printable A4 PDFs: erase handwriting, remove shadows and show-through, straighten curled pages, clear edge grime. - **[write-blog](./skills/writing/write-blog/SKILL.md)** — Write deep-analysis technical blog posts in Chinese. - **[translate-blog](./skills/writing/translate-blog/SKILL.md)** — Translate English technical blog posts to Chinese with glossary-driven terminology consistency. ## Quickstart 1. Install from `skills.sh`: ```bash npx skills@latest add samanhappy/skills ``` 2. Choose the skills you want to install. 3. Start with [`/verified-dev`](./skills/engineering/verified-dev/SKILL.md) when you want a change driven by tests first. ## Why this repo exists AI can write code quickly. That does **not** automatically mean it writes good code. I use skills like these to push agents toward better engineering habits: - clarify the behavior before changing code - prefer feedback loops over guesswork - write the smallest change that proves value - keep quality high while still shipping fast That philosophy matches how I work elsewhere too: - building [MCPHub](https://github.com/samanhappy/mcphub), a popular open-source MCP orchestration platform - practicing AI Coding + TDD daily - writing about engineering decisions and AI-native workflows at [samanhappy.com](https://samanhappy.com/) ## Reference ### Engineering - **[github-maintainer](./skills/engineering/github-maintainer/SKILL.md)** — Advance GitHub issues, PRs, security, and quality asynchronously with gh, subagents, and maintainer approval gates. - **[verified-dev](./skills/engineering/verified-dev/SKILL.md)** — Disciplined, verification-driven development with a red-green-refactor loop and visual proof. - **[optimize-prompt](./skills/engineering/optimize-prompt/SKILL.md)** — Diagnose and optimize agent prompts via decision-chain analysis and invariant fixes. ### Media - **[clip-subtitle-video](./skills/media/clip-subtitle-video/SKILL.md)** — Clip videos and burn bilingual subtitles into MP4 deliverables. ### Documents - **[clean-paper-scan](./skills/documents/clean-paper-scan/SKILL.md)** — Turn phone photos of paper documents into clean printable A4 PDFs: perspective correction, lighting normalization, handwriting erasure, de-warping, edge-grime cleanup, and verified page order. ### Writing - **[write-blog](./skills/writing/write-blog/SKILL.md)** — Write deep-analysis blog posts in Chinese. - **[translate-blog](./skills/writing/translate-blog/SKILL.md)** — Translate English technical blog posts to Chinese with glossary-driven terminology consistency. ## License [MIT](./LICENSE)

Loading the repository README…

Skills in this repository

Film & Video Editors Software Developers Technical Writers Writers & Authors

4 occupation categories · 57% classified

skill

occupation

description

updated

github-maintainer

unclassified

Advance GitHub repository issues, PRs, and Security and quality asynchronously using gh. Filter repository-wide scope, delegate all individual-item analysis and handling to isolated subagents, and queue key decisions for maintainer approval. Use for project…

2026-10-07

clean-paper-scan

unclassified

Turn phone photos of paper documents (worksheets, homework, test papers, notes, forms) into clean printable scans — correct perspective, normalize lighting, delete reverse-side show-through, erase handwriting and answer marks, de-warp curled pages, clear edge…

2026-10-07

verified-dev

unclassified

Disciplined, verification-driven engineering workflow for features, bug fixes, and safe refactors. Enforces Red → Green → Refactor for logic, before/after visual proof for UI, and rigorous validation before completion. Triggers: verified-dev, verified dev,…

2026-10-03

optimize-prompt

Software Developers

Diagnose and optimize system prompts for LLM agents using a decision-chain method. Turns individual failure cases into reusable invariant fixes instead of case-by-case patches. Use when analyzing why a model misjudged or misrouted an input, when asked to fix…

2026-08-23

clip-subtitle-video

Film & Video Editors

Clip public or local source videos into precise MP4 excerpts and add styled burned-in subtitles. Use when the user asks to find a video source, cut a speech/talk/interview segment by phrase or timestamp, create an MP4 clip, add Chinese/English bilingual…

2026-07-04

translate-blog

Technical Writers

Translate English technical blog posts to Chinese. Triggers: 翻译, translate, 翻译一下, 翻一下, translate this. Use when the user wants to translate a technical article (EN → ZH) with a natural, developer-friendly voice.

2026-07-04

write-blog

Writers & Authors

撰写中文深度分析博客文章。Triggers: 写一篇文章, 写篇博客, write a blog post, write an article about, 帮我写一篇, 来一篇关于. 适用于用户想要创建一篇结构化、洞察驱动的技术博客文章时使用。

Source text: Chinese

2026-06-09

Showing 7 of 7 collected skills.