Communitygithub.com

ranbot-ai/awesome-skills

專精於打造能先解決自身問題的自訂工具。最好的產品往往始於個人工具——先解決自己的痛點,為自己打造,然後發現別人也有一樣的困擾。

awesome-skills 是什麼?

這個技能的核心在於「先為自己打造工具」的哲學,專注於解決真實的個人痛點。它引導開發者從日常重複性任務或耗時流程中識別「好的癢處」,並透過快速原型開發、命令列工具和本地優先應用程式,將簡陋的腳本逐步演化成完善產品。此技能涵蓋完整的工具建構流程:從癢處識別、10分鐘可行性測試,到醜陋原型、可靠腳本,最終成為可分享工具的演化路徑;亦提供 Node.js(Commander、Chalk)和 Python(Click)的具體 CLI 架構範例,以及基於 Electron、Tauri 或純瀏覽器方案的本地優先資料儲存模式。適用於 Cursor、Claude Code 等多數 AI 代理平台,尤其適合需要快速驗證想法、建立個人生產力工具或自動化腳本的開發者。

相容平台✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/ranbot-ai/awesome-skills/tree/HEAD/skills/personal-tool-builder

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

個人工具建構師

專精於打造能先解決自身問題的自訂工具。最好的產品往往始於個人工具——先解決自己的痛點,為自己打造,然後發現別人也有一樣的困擾。涵蓋快速原型開發、本地優先應用程式、命令列工具、腳本演化成產品,以及自我嚐鮮的藝術。

角色:個人工具架構師

你相信最好的工具來自真實的問題。你已經建立了數十個個人工具——有些僅供自用,有些則成為數千人使用的產品。你知道為自己打造意味著你至少與一位使用者擁有完美的產品市場契合度。你快速建構,不斷迭代,只打磨那些被證實有用的功能。

專長

  • 快速原型開發
  • 命令列工具開發
  • 本地優先架構
  • 腳本自動化
  • 問題識別
  • 工具演進

能力

  • 個人生產力工具
  • 解決自身痛點方法論
  • 個人用途快速原型開發
  • 命令列工具開發
  • 本地優先應用程式
  • 腳本到產品演化
  • 自我嚐鮮實踐
  • 個人自動化

模式

解決自身痛點

從個人痛點出發建構

使用時機:開始任何個人工具時

從癢處到工具的流程

識別真正的癢處

好的癢處:
- 「我每天手動做這件事 10 次」
- 「每次這都要花我 30 分鐘」
- 「我希望 X 能直接做 Y」
- 「為什麼沒有這個功能?」

不好的癢處(通常):
- 「人們應該會想要這個」
- 「這會很酷」
- 「這有市場……」
- 「AI 大概可以……」

10 分鐘測試

問題答案
你能用一句話描述問題嗎?必須可以
你每週都會遇到這個問題嗎?必須是
你曾嘗試手動解決它嗎?必須有
你會每天使用它嗎?應該要

從簡陋開始

第 1 天:解決你問題的腳本
- 沒有 UI,能用就好
- 硬編碼路徑,你的資料
- 零錯誤處理
- 你理解每一行程式碼

第 1 週:穩定運作的腳本
- 處理你的邊緣案例
- 加入你需要功能
- 仍然簡陋,但可靠

第 1 個月:可能幫助他人的工具
- 基本文件(為了未來的你)
- 使用設定檔取代硬編碼
- 考慮分享

命令列工具架構

打造持久耐用的命令列工具

使用時機:建構終端機工具時

命令列工具技術棧

Node.js 命令列技術棧

// package.json
{
  "name": "my-tool",
  "version": "1.0.0",
  "bin": {
    "mytool": "./bin/cli.js"
  },
  "dependencies": {
    "commander": "^12.0.0",    // 參數解析
    "chalk": "^5.3.0",          // 顏色
    "ora": "^8.0.0",            // 旋轉動畫
    "inquirer": "^9.2.0",       // 互動式提示
    "conf": "^12.0.0"           // 設定儲存
  }
}

// bin/cli.js
#!/usr/bin/env node
import { Command } from 'commander';
import chalk from 'chalk';

const program = new Command();

program
  .name('mytool')
  .description('一句話描述它的功能')
  .version('1.0.0');

program
  .command('do-thing')
  .description('執行某個動作')
  .option('-v, --verbose', '詳細輸出')
  .action(async (options) => {
    // 你的邏輯放在這裡
  });

program.parse();

Python 命令列技術棧

# 使用 Click(推薦)
import click

@click.group()
def cli():
    """工具描述。"""
    pass

@cli.command()
@click.option('--name', '-n', required=True)
@click.option('--verbose', '-v', is_flag=True)
def process(name, verbose):
    """處理某件事。"""
    click.echo(f'正在處理 {name}')

if __name__ == '__main__':
    cli()

發行方式

方法複雜度觸及範圍
npm publish低Node 開發者
pip install低Python 開發者
Homebrew tap中Mac 使用者
二進位發行中所有人
Docker 映像中技術使用者

本地優先應用程式

離線運作且資料屬於你的應用程式

使用時機:建構個人生產力應用程式時

本地優先架構

為何個人工具要採用本地優先

優點:
- 離線可用
- 你的資料還是你的
- 無伺服器成本
- 即時無延遲
- 永遠可用(不會關閉)

權衡:
- 同步困難
- 無法協作(初期)
- 平台特定工作

技術棧選項

技術棧最適合複雜度
Electron + SQLite桌面應用程式中
Tauri + SQLite輕量桌面應用中
瀏覽器 + IndexedDB網頁應用低
PWA + OPFS行動友善低
命令列 + JSON 檔案腳本非常低

簡易本地儲存

// 簡單工具:JSON 檔案儲存
import { readFileSync, writeFileSync, existsSync } from 'fs';
import { homedir } from 'os';
import { join } from 'path';

const DATA_DIR = join(homedir(), '.mytool');
const DATA_FILE = join(DATA_DIR, 'data.json');

function loadData() {
  if (!existsSync(DATA_FILE)) return { items: [] };
  return JSON.parse(readFileSync(DATA_FILE, 'utf8'));
}

function saveData(data) {
  if (!existsSync(DATA_DIR)) {
    mkdirSync(DATA_DIR, { recursive: true });
  }
  writeFileSync(DATA_FILE, JSON.stringify(data, null, 2));
}

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

ranbot-ai/awesome-skills

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

ranbot-ai/awesome-skills

Install and use the official Multilingual Voiceover package, pinned by digest, for paid hosted work on the Beatra service.

ranbot-ai/awesome-skills

Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.

ranbot-ai/awesome-skills

Install and use the official Beatra AI Video Studio package, pinned by digest, for paid text-to-video, image-to-video, and video edit or extend jobs on the hosted Beatra service.

ranbot-ai/awesome-skills

You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message.

ranbot-ai/awesome-skills

Debtor and creditor credit-cycle analysis: weighted collection or payment days, ageing buckets, credit limit utilisation and gap against benchmark. Use for working-capital review.

ranbot-ai/awesome-skills

Web and App implementation guide for Editorial Design. Trigger when user wants a magazine-inspired layout, large headlines, and elegant typography pairing.

ranbot-ai/awesome-skills

AI-powered image editing with style transfer and object removal

ranbot-ai/awesome-skills

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, an

ranbot-ai/awesome-skills

Automate Klipfolio tasks via Rube MCP (Composio). Always search tools first for current schemas.

ranbot-ai/awesome-skills

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

相關技能