# SkillForge

[Bahasa Indonesia](#bahasa-indonesia) | [English](#english)

---

## Bahasa Indonesia

SkillForge adalah framework kustomisasi workspace yang dirancang untuk membangun, mengelola, dan mengoordinasikan Sub-Agent AI personal dan skill modular. Framework ini berfungsi sebagai pondasi untuk menghasilkan alur kerja agen yang bersifat platform-agnostic (independen platform).

### Fitur

- **Agent Forge (Meta-Agent):** Agen analis sistem yang mewawancarai pengguna untuk menerjemahkan permintaan samar menjadi ekosistem sub-agent kustom. Dilengkapi integrasi pencarian & validasi `skills.sh` untuk mengevaluasi skill komunitas vs membuat skill kustom presisi dari nol.
- **Graphify Codebase Knowledge Graph (`graphify`):** Mesin pemetaan arsitektur kode lokal berbasis AST Tree-sitter yang mengubah seluruh *codebase*, dokumentasi, dan skema menjadi **Knowledge Graph** terstruktur (`graph.json`, `graph.html`, `GRAPH_REPORT.md`) serta menyediakan server MCP untuk query graf deterministik.
- **Universal Browser Pilot (`browser-pilot`):** Skill kontrol browser serbaguna berbasis Chrome DevTools MCP untuk scraping web dinamis, pengisian form massal cepat (`fill_form`), pengujian responsivitas visual, dan manajemen sesi web persisten.
- **Memori User Profile:** Pembelajaran dinamis terhadap preferensi pengguna, menyimpan konteks secara lokal untuk mempersonalisasi interaksi selanjutnya.
- **Auto Update:** Integrasi bawaan dengan Git untuk secara otomatis mendeteksi dan memperbarui skill agen agar tetap sinkron.
- **Workspace Orchestrator (AGENTS.md):** Pondasi instruksi pusat yang mengotomatisasi inisialisasi profile, pemeriksaan update, dan koordinasi antar sub-agent pada setiap startup sesi.
- **Dukungan Multi-Bahasa:** Dokumentasi dan antarmuka landing page dalam dua bahasa secara langsung.

### Struktur Direktori

```
SkillForge/
├── .agents/
│   ├── skills/
│   │   ├── agent-forge/       # Meta-Agent Architect (dengan Integrasi Validasi skills.sh)
│   │   ├── graphify/          # Codebase Knowledge Graph & MCP Server Engine
│   │   ├── browser-pilot/     # Universal Browser Automation & Control (Chrome DevTools MCP)
│   │   ├── computer-use/      # OS & Desktop App Control (Orca CLI & Fallbacks)
│   │   ├── user-profile/      # Personalisasi & memori
│   │   └── auto-update/       # Sinkronisasi Git
│   └── AGENTS.md              # Workspace Orchestrator (Instruksi Utama Agen)
├── output/                    # Direktori standar untuk kustom paket Agen Mandiri & Deliverables
│   └── graphify/              # Output Knowledge Graph (graph.json, graph.html, GRAPH_REPORT.md)
├── index.html                 # Landing Page Multi-bahasa & What's New Dashboard
├── style.css                  # Desain responsif premium (Dark Glassmorphism)
├── script.js                  # Logika landing page & Graph Inspector Modal
└── README.md                  # Dokumentasi 2 Bahasa (file ini)
```

### Yang Baru (What's New)

#### Versi 1.3.0 (31 Juli 2026)
- **Graphify Knowledge Graph & MCP Server (`graphify`):** Menambahkan mesin penelusuran arsitektur *codebase* berbasis Tree-sitter AST untuk mengonversi kode dan dokumentasi menjadi Knowledge Graph (`graph.json`, `graph.html`, `GRAPH_REPORT.md`).
- **Graph Inspector & MCP Tools:** Menyediakan tools MCP terintegrasi (`query_graph`, `get_node`, `get_neighbors`, `shortest_path`) serta fitur *graph inspector/switcher* di UI/CLI untuk efisiensi penelusuran agen tanpa boros token.

#### Versi 1.2.5 (28 Juli 2026)
- **Skill Computer Use (`computer-use`):** Menambahkan skill kontrol OS & GUI desktop berbasis Orca CLI (`stablyai/orca@computer-use`) untuk inspeksi accessibility tree, aksi UI, dan otomatisasi aplikasi desktop.
- **Protokol Auto-Fallback References:** Mengonfigurasi mekanisme pemulihan otomatis (*on-demand fallback*) ke `midscene-skills` (Vision-based UI) dan `gemini-computer-use` saat terjadi kendala eksekusi.

#### Versi 1.2.0 (15 Juli 2026)
- **Obsidian Vault Manager (`obsidian-vault-manager`):** Menambahkan skill baru untuk membuat Map of Content (`000_SkillForge_MOC.md`), menyelaraskan sintaks Wikilink (`[[...]]`), dan mengekstrak tugas dari catatan Obsidian ke `task.md`.
- **Integrasi Vault Global & Protocols:** Memperbarui `AGENTS.md`, `user-profile.json`, dan `agent-forge` dengan protokol YAML frontmatter dan bidirectional linking Obsidian untuk tampilan Graph View yang seamless.

#### Versi 1.1.0 (14 Juli 2026)
- **Universal Browser Pilot (`browser-pilot`):** Menambahkan skill universal baru untuk otomatisasi Chrome via MCP (dynamic scraping, pengisian form massal, audit responsivitas, dan sesi persisten).
- **Validasi & Discovery `skills.sh`:** Mengintegrasikan mesin pencari & validasi `skills.sh` ke dalam `agent-forge` untuk mengevaluasi kecocokan skill komunitas vs membuat skill kustom dari nol.
- **Integrasi Protocol:** Memperbarui jembatan multi-agen (`CLAUDE.md`, `.cursorrules`, `task.md`) dengan dukungan fitur universal baru.

#### Versi 1.0.0 (4 Juli 2026)
- **Rilis Awal:** Meluncurkan pondasi utama SkillForge.
- **Meta-Agent Architect:** Membuat skill `agent-forge` untuk merancang sub-agent dan skill secara interaktif.
- **Memori & Pembaruan Inti:** Menambahkan `user-profile` untuk pembelajaran pengguna secara dinamis dan `auto-update` untuk sinkronisasi otomatis menggunakan Git.
- **Dokumentasi & UI:** Menambahkan dokumentasi satu file dalam 2 bahasa, serta antarmuka landing page yang responsif.

### Memulai & Instalasi

**Opsi 1: Instalasi Cepat via NPM (Direkomendasikan)**
Jalankan perintah berikut di terminal direktori proyek Anda:
```bash
npx skills add https://github.com/lensetek/SkillForge
```
*Penjelasan:* Perintah ini menggunakan utilitas CLI `skills` untuk secara otomatis mengunduh, mengekstrak, dan mengonfigurasi ekosistem agen SkillForge langsung ke dalam workspace Anda.

**Opsi 2: Instalasi Manual**
1. Atur Workspace AI Anda untuk mengarah ke direktori ini.
2. Agen akan otomatis mendeteksi dan memuat skill dari folder `.agents`.
3. Panggil `agent-forge` untuk mulai merancang alur kerja baru Anda.

**Opsi 3: Instalasi Otomatis via AI Prompt (Tanpa Git Clone)**
Cukup salin dan tempel instruksi berikut ke AI Agent Anda (seperti Gemini, Claude, atau Cursor):

> "Tolong unduh framework SkillForge dari `https://github.com/lensetek/SkillForge/archive/refs/heads/master.zip`. Jangan gunakan `git clone`. Unduh file zip tersebut, ekstrak isinya ke dalam direktori workspace ini, dan pastikan folder `.agents` terpasang dengan benar sebagai kustomisasi workspace saya. Setelah itu, baca `SKILL.md` dari `agent-forge` untuk memahami peranmu."

### Usecase & Contoh Penggunaan

#### Usecase: Mengubah Keluhan Harian Menjadi Otomatisasi
Anda merasa kewalahan karena setiap hari harus meriset berita teknologi terbaru dan menulis rangkumannya untuk audiens LinkedIn Anda. Ini memakan waktu berjam-jam.

**Langkah demi Langkah (Skenario Percakapan):**
1. **Ceritakan Masalah Anda:** Anda cukup mengeluh atau curhat ke AI Agent utama di workspace ini:
   > *"Saya capek sekali setiap hari harus mencari berita AI terbaru dan menulis rangkumannya untuk LinkedIn. Habis waktu berjam-jam!"*
2. **AI Menganalisis & Merekomendasikan Solusi:** AI Agent Anda menganalisis keluhan tersebut dan menawarkan solusi:
   > *"Saya memahami kendala Anda. Ini adalah masalah riset dan penulisan yang repetitif. Saya merekomendasikan pembuatan sistem otomatis yang terdiri dari dua sub-agent: satu untuk riset berita tepercaya, dan satu untuk menulis draf sesuai gaya bahasa Anda."*
3. **Kolaborasi Cetak Biru (Wawancara):** Agen menjalankan perintah slash `/agent-forge` untuk mewawancarai Anda secara santai guna memperjelas detail cetak biru:
   > *"Apakah Anda ingin rangkuman berita ini bersifat harian atau mingguan? Apa saja sumber berita yang Anda percayai? Dan bagaimana gaya bahasa yang Anda sukai?"*
4. **Instalasi Otomatis:** Setelah Anda menyetujui cetak biru rancangannya, Anda cukup mengetik konfirmasi:
   > *"Desain bagus, tolong pasang sekarang."*
   Agen otomatis membuat file sub-agent dan skill yang diperlukan ke disk.
5. **Masalah Terselesaikan:** Workspace memuat ulang sistem baru ini secara otomatis. Sekarang Anda cukup mengetik perintah slash kustom `/write-post` (atau cukup meminta: *"Tolong rangkum berita AI terpopuler hari ini"*) dan sistem sub-agent kustom Anda akan menyelesaikan seluruh tugas tersebut dalam hitungan detik.

---

## English

SkillForge is a workspace customization framework designed to build, manage, and orchestrate personalized AI Sub-Agents and modular skills. It serves as a foundation for generating platform-agnostic workflows.

### Features

- **Agent Forge (Meta-Agent):** A system analyst agent that interviews users to translate high-level requests into customized sub-agent ecosystems. Now equipped with `skills.sh` discovery & validation to evaluate community skills vs building tailored skills from scratch.
- **Graphify Codebase Knowledge Graph (`graphify`):** Tree-sitter AST codebase analysis engine that parses source code and docs into queryable **Knowledge Graphs** (`graph.json`, `graph.html`, `GRAPH_REPORT.md`) and exposes an MCP server for token-efficient graph traversal.
- **Universal Browser Pilot (`browser-pilot`):** A domain-agnostic web automation and inspection skill powered by Chrome DevTools MCP for dynamic web scraping, fast form population (`fill_form`), visual auditing, and persistent web sessions.
- **User Profile Memory:** Dynamic learning of user preferences, storing context locally to personalize subsequent interactions.
- **Auto Update:** Built-in git integration to automatically fetch and pull changes to keep skills synchronized.
- **Workspace Orchestrator (AGENTS.md):** Central instruction foundation that automates profile initialization, updates checks, and coordinates work delegation between sub-agents on every session startup.
- **Multilingual Support:** Multi-language documentation and landing page interfaces out-of-the-box.

### Directory Structure

```
SkillForge/
├── .agents/
│   ├── skills/
│   │   ├── agent-forge/       # The Meta-Agent Architect
│   │   ├── graphify/          # Codebase Knowledge Graph & MCP Server Engine
│   │   ├── browser-pilot/     # Universal Browser Automation & Control
│   │   ├── computer-use/      # OS & Desktop App Control (Orca CLI & Fallbacks)
│   │   ├── user-profile/      # Personalization & memory
│   │   └── auto-update/       # Git-based synchronization
│   ├── user-profile.json      # Memory preference storage
│   └── AGENTS.md              # Workspace Orchestrator (Central Agent Instructions)
├── output/                    # Standardized directory for newly forged Agent packages
│   └── graphify/              # Knowledge Graph outputs (graph.json, graph.html, GRAPH_REPORT.md)
├── index.html                 # Multilingual Landing Page & What's New Dashboard
├── style.css                  # Premium responsive design (Dark Glassmorphism)
├── script.js                  # Landing page logic & Graph Inspector Modal
└── README.md                  # Bilingual documentation (this file)
```

### What's New

#### Version 1.3.0 (July 31, 2026)
- **Graphify Knowledge Graph & MCP Server (`graphify`):** Added Tree-sitter AST parsing engine converting codebase structures and documentation into persistent Knowledge Graphs (`graph.json`, `graph.html`, `GRAPH_REPORT.md`).
- **Graph Inspector & MCP Tools:** Integrated MCP tools (`query_graph`, `get_node`, `get_neighbors`, `shortest_path`) and web/CLI graph state inspection to eliminate token waste from raw grepping.

#### Version 1.2.5 (July 28, 2026)
- **Computer Use Skill (`computer-use`):** Added OS & desktop GUI control skill powered by Orca CLI (`stablyai/orca@computer-use`) for accessibility tree inspection, UI actions, and desktop app automation.
- **Auto-Fallback References Protocol:** Configured on-demand fallback recovery mechanisms pointing to `midscene-skills` (Vision UI) and `gemini-computer-use` for seamless execution error recovery.

#### Version 1.2.0 (July 15, 2026)
- **Obsidian Vault Manager (`obsidian-vault-manager`):** Added new skill for generating Map of Content (`000_SkillForge_MOC.md`), formatting Wikilinks (`[[...]]`), and extracting checklist tasks into `task.md`.
- **Global Vault Protocols:** Updated `AGENTS.md`, `user-profile.json`, and `agent-forge` to enforce Obsidian YAML frontmatter and bidirectional wikilinks for full Graph View compatibility.

#### Version 1.1.0 (July 14, 2026)
- **Universal Browser Pilot (`browser-pilot`):** Added new universal browser control skill powered by Chrome DevTools MCP (dynamic web scraping, form batching, layout visual auditing, and session persistence).
- **`skills.sh` Validation Engine:** Integrated community skill search & evaluation into `agent-forge` with automated fallback to forge custom skills when candidates don't match requirements.
- **Protocol Upgrades:** Updated cross-agent interoperability configurations (`CLAUDE.md`, `.cursorrules`, `task.md`) for all major AI coding assistants.

#### Version 1.0.0 (July 4, 2026)
- **Initial Release:** Launched the SkillForge foundation.
- **Meta-Agent Architect:** Created the `agent-forge` skill to generate sub-agents and skills interactively.
- **Core Memory & Updates:** Added `user-profile` for dynamic user learning and `auto-update` for Git synchronization.
- **Documentation & UI:** Added consolidated bilingual documentation and a responsive landing page interface.

### Getting Started & Installation

**Option 1: Quick Installation via NPM (Recommended)**
Run the following command in your project directory terminal:
```bash
npx skills add https://github.com/lensetek/SkillForge
```
*Explanation:* This command runs the `skills` CLI utility to automatically download, extract, and configure the SkillForge agent ecosystem directly into your workspace.

**Option 2: Manual Setup**
1. Set up your AI Workspace to point to this directory.
2. The agent will automatically discover and load the skills from the `.agents` root.
3. Call `agent-forge` to start designing new workflows.

**Option 3: Automatic Setup via AI Prompt (No Git Clone)**
Simply copy and paste the following prompt to your AI Agent (like Gemini, Claude, or Cursor):

> "Please download the SkillForge framework from `https://github.com/lensetek/SkillForge/archive/refs/heads/master.zip`. Do not use `git clone`. Download the zip file, extract its contents into this workspace directory, and ensure the `.agents` folder is properly set up as my workspace customization root. After that, read the `SKILL.md` from `agent-forge` to understand your new role."

### Use Cases & Usage Example

#### Use Case: From Daily Frustrations to Automation
You are overwhelmed because you spend hours every day researching the latest AI news and writing summaries for your LinkedIn audience.

**Step-by-Step Example (Conversational Journey):**
1. **Share Your Pain Point:** Simply tell the main AI Agent in your workspace:
   > *"I'm exhausted researching AI news and writing daily summaries for my LinkedIn audience. It takes hours!"*
2. **AI Identifies & Recommends Solution:** The AI Agent analyzes your frustration and recommends a solution:
   > *"I hear you. This is a classic research and content creation bottleneck. I recommend building a custom system with two specialized sub-agents: one for researching news from trusted sources, and another for writing drafts in your personal style."*
3. **Collaborative Design (The Interview):** The agent runs the `/agent-forge` slash command to start a conversational interview to design the blueprint:
   > *"Would you like daily or weekly summaries? What news sources do you trust? And how would you describe your target writing tone?"*
4. **Automatic Installation:** Once you approve the proposed design, simply confirm:
   > *"Approved. Write all these skills to disk."*
   The agent automatically generates all sub-agent and tool files.
5. **Problem Resolved:** The workspace automatically reloads the new system. Now you can simply run the new slash command `/write-post` (or instruct: *"Summarize today's top tech news"*) and your custom sub-agents will run the entire workflow in seconds.