twhsi/skills
요약
twhsi/skills는 Claude Code, Codex, Gemini 등 다양한 LLM 에이전트가 사용할 수 있는 공개 에이전트 기술 레지스트리입니다. iMandalArt과 BIRD 시스템을 통해 지식 압축, 주소 지정, 발행 워크플로를 자동화하여 에이전트가 반복 가능한 기술을 수행하도록 설계되었습니다.
핵심 포인트
- LLM 에이전트를 위한 설치 및 공유 가능한 기술 레지스트리 제공
- iMandalArt을 통한 정보 압축 및 FIRE 의미 분석 적용
- BIRD 시스템을 활용한 지식 객체의 주소 지정 및 경로 부여
- 인간의 판단력을 유지하며 AI가 반복적 구조를 처리하는 워크플로 지향
Three Kings 2.2: iMandalArt으로 압축하고, BIRD로 주소를 지정하며, A4 8페이지 소책자로 발행합니다.
Claude Code, Codex, 그리고 주류 LLM 에이전트(LLM agents)를 위한 iMandalArt, FIRE 의미 분석 (semantic analysis), 계획 (planning), 그리고 발행 워크플로 (workflows)입니다.
이 저장소는 중국 지식 노동자들을 위한 TWHSI의 공개 에이전트 기술 시스템 (agent-skill system)입니다. 반복 가능한 글쓰기, 계획, 노트 작성, 그리고 발행 워크플로를 Claude Code, Codex, ChatGPT, Gemini, Hermes 및 기타 LLM 에이전트가 사용할 수 있는 기술 (skills)로 변환합니다.
신뢰할 수 있는 정보의 원천 (source of truth)은 skills/*/SKILL.md에 존재합니다.
; skill-tree.json은 Three Kings 관계를 기록하며, 웹사이트는 이 기술들을 생성된 LLM 매니페스트 (manifests), 검색 가능한 인덱스 (index), 설치 명령 (install commands), 개정 (revisions), 그리고 업데이트 타임스탬프 (update timestamps)로 변환합니다.
twhsi/skills는 설치 가능하고, 공유 가능하며, LLM이 읽을 수 있는 기술 레지스트리 (skill registry)입니다. 주간 검토, iMandalArt, FIRE 분석, 카드 기반 노트, EPUB 발행, HyperCard 반환, 그리고 데스크톱 작업을 위한 장기 실행 워크플로를 에이전트가 반복할 수 있고 인간이 검사할 수 있는 공개 절차 (public procedures)로 변환합니다.
핵심은 인간을 더 빠른 기계처럼 행동하게 만드는 것이 아닙니다. 핵심은 AI가 반복적인 구조에 토큰 (tokens)을 소비하게 하는 동안, 인간은 판단력, 관계, 속도, 그리고 더 조용한 질문을 유지하는 것입니다:
어떤 행동이 진정한 행복과 평화를 가져다주는가?
플래그십 워크플로 (flagship workflow)는 Skills 三大天王 2.2입니다: imandalart는 소스를 압축하고, thebrain-bird-address는 모든 지식 객체에 주소와 경로 (Route)를 부여하며, a4-eight-page-booklet은 구조를 검증된 종이 책으로 되돌려줍니다.
라이브 사이트: https://www.twhsi.com/
라이브 키워드 그래프 (Live Keyword Graph): https://keyword-graph-view.twhsi.chatgpt.site/
에이전트 매니페스트 (Agent manifest): https://www.twhsi.com/agent.json
기술 인덱스 (Skill index): https://www.twhsi.com/skills.json
LLM 컨텍스트 (LLM context): https://www.twhsi.com/llms.txt
- 소스 자료를 iMandalArt 2.2 하드라인 9그리드 카드(9-grid cards)로 변환합니다.
- 카드 박스 사고(card-box thinking), 검색(retrieval), 그리고 집필 구조를 위해 FIRE 의미론적 분석(semantic analysis)을 적용합니다.
- 영구 노트(permanent notes)를 BIRD 2.1 북 어드레스(Book Addresses), 구조화된 지식 인덱스(Knowledge Indexes), 경로(Routes), 검증된 딥 링크(Deep Links), 의미론적 역할(Semantic Roles), 그리고 TheBrain 원고 스캐폴드(manuscript scaffolds)로 전환합니다.
concise-key-points를 사용하여 답변을 압축합니다.
: 필수 정보의 최소 95%를 유지하면서 기본 길이를 70% 줄입니다. - 소스 자료를 검증된 A4 1매 8페이지 소책자(booklet), 동기화된 읽기용 PDF, 인쇄용 임포지션(print imposition), 그리고 편집 가능한 DOCX로 편찬합니다.
agent.json,skills.json,llms.txt를 통해 에이전트가 읽을 수 있는 메타데이터(metadata)를 생성합니다. - 일간 계획, 주간 계획, 소책자, EPUB, Markdown, 그리고 지식 관리(knowledge-management) 워크플로우를 경로 지정(Route)합니다.- 8개의 키워드를 추출하고 정의, 근거, 블랙리스트 제어가 포함된 분산 가중 그래프(distributed weighted graph)를 렌더링합니다.
- LLM 에이전트가 일관되게 작동할 수 있도록 중국어 우선(Chinese-first) 워크플로우를 패키징합니다.
입력(Input): 원고(manuscript), 노트, PDF 또는 긴 대화
기술(Skills): imandalart 2.2 -> thebrain-bird-address 2.2 -> a4-eight-page-booklet 2.2
출력(Output): 8각 인덱스(eight-angle index) -> BIRD 주소 및 경로(Routes) -> 읽기용 PDF + 인쇄용 시트 + DOCX
소재
-> iMandalArt 2.2: 하나의 중심, 8개의 직교 관점
-> BIRD 독서 분석(拆書分析) 2.2: Book Address, W+T+K+A, Route, Deep Link
...
| 기술 (Skill) | 책임 (Responsibility) | 최적 용도 (Best use) |
|---|---|---|
iMandalArt 2.2 | 압축의 왕: 혼합된 소재를 하나의 중심과 8개의 중복되지 않는 관점으로 압축합니다. | 일간 계획, 장(chapter) 개요, 64+8+1, 모바일 9그리드 카드. |
BIRD 독서 분석 2.2 | 주소의 왕: 주장을 위치 지정 가능하고, 검색 가능하며, 장(chapter) 간 연결 가능한 지식 노드로 변환합니다. | 독서 분석(拆書), TheBrain, Excel, Roam, Obsidian, 원고 경로(Route). |
A4 8페이지 소책자 2.2 | 출판의 왕: 9그리드 개요와 7개의 경로(Routes)를 읽기 가능하고, 인쇄 가능하며, 편집 가능한 소책자로 변환합니다. | A4 접지 책자, 읽기용 PDF, 종이 기반 사고, 교육 및 출판 검증. |
공유 핸드오프 (Shared handoff): 중심, 8개 각도, 소스 ID, BIRD 주소, 경로(Route) 및 인용은 종이 매체까지 그대로 유지됩니다. 7-경로 출판 (Seven-Route publishing): 1페이지에는 iMandalArt 개요를 배치하고, 2~8페이지에는 7개의 BIRD 경로(Routes)를 배치합니다. 하위 호환성 (Backward compatibility): BIRD는 여전히 BIRD-2.1을 출력하며, 소책자는 여전히 BookletManifest 2.0을 읽습니다. 기계 판독 가능 트리 (Machine-readable tree): skill-tree.json은 세 가지 요소의 버전, 성숙도, 출력 및 해제(unlock) 관계를 기록합니다.
keyword-graph-view
keyword-graph-view는 중국어, 영어 또는 혼합된 텍스트를 정확히 8개의 키워드로 구성된 분산 네트워크로 변환합니다. 블랙리스트에 포함된 용어를 제거하고, W1에서 W9까지의 공기(co-occurrence) 에지(edge)에 가중치를 부여하며, 모든 노드에 정의, 노트 및 출처 근거를 제공합니다.
라이브 도구 열기: keyword-graph-view.twhsi.chatgpt.site
weekly-reverse-review는 11단계의 주간 검토(weekly review)를 AI 보조 역계획(reverse planning) 루프로 변환합니다.
이 스킬은 다음 주를 작성하기 전에 네 가지 관점을 읽습니다:
YEAR: 연간 계획 및 백년 인생 계획.
Week: 지난 주간 계획 및 주간 검토.
Day: 일일 계획, 7일간의 일기 노트 및 캘린더 근거.
Inbox: 느슨한 작업, 리마인더, 구독, 심부름 및 수집된 노이즈.
그 후 무엇을 더 작게, 더 느리게, 삭제하거나, 지연시키거나, 성취 대신 현존(presence)으로 유지해야 하는지 묻습니다. 핵심 질문은 다음과 같습니다:
어떤 행동이 진정한 행복과 평화를 가져오는가?
기본 답변:
말을 줄여라. 현재에 머물러라. 천천히 움직여라.
LLM 또는 에이전트(agent)를 위한 시작점:
curl -s https://www.twhsi.com/llms.txt
imandalart는 느슨한 소스 자료를 하나의 확고한 3x3 만다라(Mandala) 인덱스 카드로 변환합니다.
iMandalArt 2.2는 엄격한 텍스트 계약(text contract)을 중심으로 설계되었습니다:
Ⓐ부터Ⓗ까지 라벨이 붙은 8개의 직교하는 주변 각도.◎◎◎◎◎로 표시되는 이중 중심축.- 정확히 11개의 물리적 텍스트 라인으로 구성되어 채팅 미리보기, 노트 앱 및 클립보드 워크플로에서 형식이 유지됩니다.
- TheBrain/Cerebro, Hermes, Discord, Codex 및 기타 LLM 채팅 인터페이스를 위한 CJK(한중일) 친화적인 컴팩트한 셀(cell).
현재 상태: iMandalArt 2.2는 CJK 워크플로, 순수 텍스트 안정성, の字(노지)형 정체성 보존, 그리고 BIRD 및 booklet Routes로의 깔끔한 인계에 최적화되어 있습니다.
개념적 예시:
Ⓐ건강 재설정 Ⓑ원고 Ⓒ금전적 노이즈
주의하며 움직이기 중심축 하나 당겨서 먼저 검토하기
리듬 만들기 모든 것 이전에 초안 작성하기 작업 자금 마련하기
...
주간 계획, 글쓰기 집중, 지식 캡처, 그리고 시각적 안정성이 의미적 압축만큼 중요한 CJK 노트 워크플로에 사용하세요.
thebrain-bird-address
thebrain-bird-address는 원고와 영구 노트(permanent notes)를 주소 지정이 가능한 지식 객체(knowledge objects)로 변환합니다. 2.2 Skill 릴리스는 하위 호환이 가능한 BIRD 2.1 프로토콜을 적용합니다: B = Book Address (도서 주소), I = Weight + Type + Keyword + Alias (가중치 + 유형 + 키워드 + 별칭), R = Route (경로), D = exact Deep Link (정확한 딥 링크)를 사용하며, 선택적으로 증거 기반의 의미적 역할(Semantic Roles)을 포함합니다. 이는 Excel, TheBrain 스캐폴드(scaffolds), Roam JSON, 단색 더블 나인 그리드(monochrome double nine-grids), 그리고 직접적인 7-경로(seven-Route) 소책자 전달을 지원합니다.
concise-key-points는 정보 밀도가 높은 답변을 생성합니다: 결론 우선, 3~5개의 핵심 포인트, 최소한의 반복, 그리고 불필요한 배경 설명 배제를 원칙으로 합니다. 기본 목표는 필수 정보의 최소 95%를 유지하면서 길이를 70% 단축하는 것입니다.
a4-eight-page-booklet은 텍스트, 노트, 이미지, BIRD Graph JSON, iMandalArt 그리드, 64+8+1 구조, FIRE 자료, 일일 계획, Bike 또는 Bonsai 개요, 템플릿, 그리고 PDF를 하나의 A4 용지로 만들 수 있는 인쇄 가능하고, 자를 수 있으며, 접을 수 있는 8페이지 소책자로 변환합니다.
이 스킬은 단순히 콘텐츠를 8개의 패널에 배치하는 것 이상의 기능을 수행합니다. 콘텐츠를 레이아웃으로부터 분리하고, 소스를 BookletManifest 2.0으로 정규화하며, 동일한 매니페스트(manifest)로부터 모든 읽기, 인쇄, 미리보기 및 검증 아티팩트(artifact)를 생성합니다.
- 1페이지는 표지와 개요를 담을 수 있습니다. BIRD 또는 64+8+1 모드에서는 하나의 디렉토리 나인 그리드(directory nine-grid)와 하나의 키워드 나인 그리드(keyword nine-grid)를 포함합니다.
- 2
8페이지는 7개의 경로(Routes)를 형성할 수 있습니다. 각 페이지는 하나의 중심 주장, 35개의 간결한 포인트, 그리고 하나의 순서화된 읽기 경로를 유지합니다. - iMandalArt 나선형 순서 좌표는 소스 ID, BIRD 주소, 인용구, 그리고 경로 간 노트(cross-route notes)와 함께 보존됩니다.
- 출력물에는 8개의 세로형 A7 페이지 PDF, 8페이지 읽기용 PDF, A4 가로형 인쇄 배치(imposition), 편집 가능한 DOCX, 미리보기 이미지, 그리고 검증 보고서가 포함됩니다.
- 고정된 배치(imposition) 순서는 상단 행에 세로로
6, 7, 8, 1이 위치하고, 하단 행에 180도 회전된 상태로5, 4, 3, 2가 위치합니다. - 검증(Validation)은 구조, 타이포그래피, 배치, 시각적 품질, Apple Pages 호환성, 그리고 요구 시 소스 충실도(source fidelity)를 확인합니다.
전체 스킬 사양 및 설치 소스: skills/a4-eight-page-booklet/SKILL.md
- 중국어 에이전트 워크플로 (agent workflows)를 위한 GitHub 기반 스킬 레지스트리 (skill registry).
- 라우팅 (routing), 설치 명령 (install commands), 리소스 발견 (resource discovery)이 필요한 LLM 에이전트를 위한 기계 판독 가능 인덱스 (machine-readable index).
- 어떤 워크플로를 재사용 가능한 스킬 (reusable skills)로 만들지 결정하기 위한 인간 판독 가능 맵 (human-readable map).
- 각 스킬이 선언될 때의 시맨틱 버전 (semantic version), 최신 Git 리비전 (Git revision), 그리고 최신 업데이트 시간을 게시하는 정적 웹사이트 (static website).
| 스킬 (Skill) | 역할 (Role) |
|---|---|
imandalart | |
| iMandalArt 2.2 압축의 왕: 하나의 중심과 8개의 직교 검색 각도. | |
fire-analysis-card | |
| 중국어 노트와 원고를 FIRE 시맨틱 분석 카드 (semantic analysis cards)로 변환. | |
thebrain-bird-address | |
| BIRD 2.2 주소의 왕: 검증된 지식 주소, Routes, Excel, TheBrain, Roam, 그리고 인쇄 가능한 인덱스. | |
concise-key-points | |
| 필수적인 사실, 제약 조건, 그리고 실행 항목 (action items)을 유지하면서 답변을 가장 적은 유용한 단어로 압축. | |
todays-daily-plan | |
| 말하는 계획 노트를 Obsidian 데이 플랜 만다라 그리드 (day-plan Mandala grid)로 변환. | |
weekly-reverse-review | |
| 연도(YEAR), 주(Week), 일(Day), 그리고 인박스(Inbox) 증거를 행복과 평화 중심의 하나의 주간 계획으로 변환. | |
keyword-graph-view | |
| 8개의 키워드를 추출하고 노드 노트와 증거를 포함한 중심 없는 가중치 네트워크 (centerless weighted network) 구축. | |
a4-eight-page-booklet | |
| A4 소책자 2.2 출판의 왕: PDF 읽기, 인쇄 임포지션 (print imposition), 편집 가능한 DOCX, 미리보기, 그리고 검증. | |
project-note-json-to-epub | |
| 구조화된 프로젝트 노트 JSON을 EPUB 및 출판 결과물로 변환. | |
markdown-nine-grid-clipboard | |
| 그리드와 카드를 Markdown 테이블 워크플로로 변환. |
fire-analysis-card는
이제 FIRE 2.0 단계에 있습니다:
F = Full-D
: 임시, 영구, 그리고 프로젝트 노트를 위한 안정적인 번호 매기기.
I = Index
: 키워드 웹 (keyword webs)과 검색 핸들 (retrieval handles).
R = Route
: 자료를 관통하는 사고 경로 (thinking paths).
E = Evolution
: 시맨틱 검색 (semantic search)을 위한 시간 기반의 카드 박스 성장.
라이브 웹사이트는 매 배포(deployment) 시마다 스킬 파일과 Git 히스토리로부터 최신성 메타데이터(freshness metadata)를 생성합니다. 각 스킬 항목에는 다음이 포함됩니다:
version
: 선언된 시점의 시맨틱 스킬 버전 (version), 선언되지 않은 경우 Unversioned
revision 및 revision_short
: 해당 스킬 경로의 최신 Git 커밋 (commit)
updated_at
: 해당 스킬 경로의 최신 업데이트 타임스탬프 (timestamp)
생성된 라이브 테이블을 확인하세요:
주요 릴리스 확인: iMandalArt, BIRD Book Deconstructor, 그리고 A4 Eight Page Booklet이 함께 Skills 三大天王 2.2로 제시됩니다. 이들의 안정적인 상호 교환 형식(interchange formats)은 하위 호환성(backward compatible)을 유지합니다.
thebrain-bird-address는 BIRD 2.1을 구현합니다: B = Book Address (도서 주소), I = Weight + Type + Keyword + Alias (가중치 + 유형 + 키워드 + 별칭), R = Route (경로), 그리고 D = exact Deep Link (정확한 딥링크)이며, 선택적으로 증거 기반의 시맨틱 역할(Semantic Roles)을 포함합니다. 이는 재사용 가능한 영구 노트(permanent notes)에서 프로젝트 노트, 장(chapter) 구조, 그리고 도서 제작으로 확장함으로써 FIRE를 보완합니다.
| 경로 (Route) | 목적 (Purpose) | 대표 스킬 (Representative skills) |
|---|---|---|
| Time | 일일 집중, 계획 리듬, 캘린더 작업, 주간 검토, 그리고 장기 훈련 루프. | weekly-reverse-review , todays-daily-plan , imandalart , personal-athlete-81-grid , fantastical-calendar |
| ... |
assets/ public display assets (공개 디스플레이 자산)
skills/ installable skills for mainstream LLM workflows (주류 LLM 워크플로우를 위한 설치 가능한 스킬)
docs/ install notes, book links, and skill index (설치 노트, 도서 링크, 스킬 인덱스)
...
리포지토리(repository) 루트에서:
cp -R skills/fire-analysis-card ~/.codex/skills/
cp -R skills/thebrain-bird-address ~/.codex/skills/
cp -R skills/concise-key-points ~/.codex/skills/
...
그 다음 스킬을 검증합니다:
python3 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/fire-analysis-card
npm run build
빌드(build) 과정은 skills/*/SKILL.md를 읽고, 프론트매터(frontmatter)를 추출하며, 선언된 버전을 감지하고, Git에 스킬별 최신 리비전 타임스탬프를 요청한 뒤 다음을 작성합니다:
dist/agent.json
dist/skills.json
dist/llms.txt
- 정적 HTML/CSS/JS 사이트
Vercel 설정은 vercel.json에 위치합니다: 빌드 명령(build command) npm run build
, 출력 디렉토리 (output directory) dist
.
스킬 (skill)이 변경되면, 먼저 스킬 파일을 업데이트하고, 유효성 검사 (validation)를 실행한 후, 웹사이트를 다시 빌드(rebuild)하고 main 브랜치로 푸시(push)하세요.
.
라이브 사이트 (live site)는 항상 최신 스킬 버전 (skill version), 리비전 (revision), 그리고 업데이트 시간 (update time)을 보여주어야 합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Coding Assistants의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기