Technical Writing

seo 스킬은 기술 SEO, 온페이지 최적화, 구조화 데이터, Core Web Vitals, 키워드 매핑을 점검하고 계획하며 구현하는 데 도움이 됩니다. 크롤링 가능성, 인덱싱 가능성, 메타데이터, 스키마, 내부 링크, 사이트맵 및 robots 변경 사항이 필요할 때, 또는 Keyword Research용 seo가 필요할 때 사용하면 페이지별로 바로 실행할 수 있는 구체적인 가이드를 제공합니다.

java-coding-standards skill은 Spring Boot 서비스에서 읽기 쉽고 유지보수하기 좋은 Java 17+ 코드를 작성하도록 돕는 실용 가이드를 제공합니다. 네이밍, 불변성, Optional, 스트림, 예외, 제네릭, 패키지 구조를 다루며, 코딩·리팩터링·Code Review에서 java-coding-standards를 활용할 수 있습니다.

cpp-coding-standards는 C++ Core Guidelines를 기반으로 한 C++ 코딩 표준 가이드입니다. 안전성, 명확성, 유지보수성, RAII, 타입 안전성, 좋은 설계를 중시하는 현대 C++ 작성, 리뷰, 리팩터링에 사용하세요. Code Review와 실무적인 팀 의사결정에 적합한 cpp-coding-standards입니다.

code-tour은 실제 파일과 줄 앵커를 포함한 재사용 가능한 CodeTour `.tour` 파일을 만듭니다. 온보딩 투어, 아키텍처 둘러보기, PR 투어, RCA 경로, 그리고 단계별 안내가 평면적인 요약보다 더 적합할 때의 Technical Writing용 code-tour에 이 스킬을 사용하세요.

article-writing 스킬은 구조, 톤의 일관성, 근거를 갖춘 긴 글 초안을 만드는 데 도움이 됩니다. 기사, 가이드, 튜토리얼, 뉴스레터는 물론, 다듬어 바로 발행할 수 있는 문장이 중요한 Copywriting 워크플로에서도 활용하기 좋습니다.

architecture-decision-records는 Claude Code 세션 중 발생하는 아키텍처 결정을 구조화된 ADR로 기록하도록 돕습니다. 의사결정 시점을 감지해 맥락, 대안, 근거를 남기고, 향후 유지보수를 위한 ADR 로그를 유지합니다. 오래 남는 결정 이력이 필요한 Technical Writing 및 엔지니어링 팀에 유용합니다.

api-design은 엔드포인트 기획 및 리뷰, 리소스 네이밍, 상태 코드, 페이지네이션, 필터링, 버저닝, 오류 응답 설계를 다루는 REST API 설계 스킬입니다.

brainstorming은 구현 전에 맥락을 탐색하고, 한 번에 하나씩 확인 질문을 던지며, 어떤 코드 작업보다 먼저 설계 승인을 요구하는 사전 구현용 스킬입니다. 선택형 visual companion을 함께 쓸 수 있고 Requirements Planning도 강하게 지원합니다.

writing-plans는 spec이나 requirements 문서를 코딩 시작 전 검토 가능한 상세 구현 계획으로 정리해 주는 스킬입니다. 파일 단위 가이드, 작업 순서, 테스트 단계, 리뷰 프롬프트까지 포함해 계획 수립을 체계화하는 데 도움이 됩니다.

doc-coauthoring은 AI와 함께 문서를 작성할 때 쓰는 구조화된 워크플로입니다. 맥락 수집, 반복적 개요 정리, 섹션별 집필, 독자 테스트를 거쳐 검토 가능한 spec, RFC, proposal 초안을 만드는 데 적합합니다.

technical-writer는 더 명확한 README, API 문서, 설정 가이드, 튜토리얼, 온보딩 문서, 릴리스 노트를 만들기 위한 가벼운 문서화 스킬입니다. 기술 문서를 사용자 목표, 빠른 시작, 예시, 문제 해결 중심으로 구성하도록 돕습니다. 추가 스크립트나 템플릿 없이 단일 SKILL.md 파일로 제공됩니다.

document-release는 배포 이후 문서 갱신을 위한 스킬로, 프로젝트 문서를 읽고 배포된 diff와 대조한 뒤 README, ARCHITECTURE, CONTRIBUTING, CLAUDE.md, CHANGELOG, VERSION을 업데이트해 실제 배포 내용과 문서가 일치하도록 맞춥니다. 코드가 이미 병합된 뒤 신뢰할 수 있는 document-release 가이드가 필요할 때 기술 문서 작성에 이 스킬을 사용하세요.

caveman은 기술 답변, 요약, 디버깅 도움말을 아주 압축된 형식으로 전달하는 커뮤니케이션 skill입니다. 기술적 의미는 그대로 유지하고 군더더기는 덜어내며, 중단하라고 말할 때까지 트리거 이후 계속 활성 상태를 유지합니다. 이미 주제를 잘 알고 있을 때의 기술 문서 작성, 코드 리뷰 메모, 장애 업데이트, 더 빠른 주고받기에 특히 적합합니다.

edit-article 스킬은 기존 초안을 재구성하고, 명확성을 높이며, 문장을 더 간결하게 다듬는 데 도움이 됩니다. 특히 섹션 순서와 의존성이 중요한 기술 문서 작성 워크플로에서 글을 수정할 때 신뢰할 수 있는 edit-article 가이드가 필요하다면 사용하세요.

writing-shape은 마크다운 원재료를 출판 가능한 기사로 다듬어 주는 대화형 초안 작성 스킬입니다. 오프닝 선택, 문단별 전개, 구조 결정에 도움이 되며, 기술 문서, 인터뷰 메모, 녹취 정리, 거친 초안 작업에 특히 유용합니다. 한 번에 끝내는 프롬프트보다 단계별 편집 과정을 원할 때 writing-shape 가이드를 사용하세요.

grill-with-docs는 계획과 문서화를 위한 스킬로, 레포의 기존 도메인 모델을 기준으로 당신의 계획을 검증하고, 용어를 다듬으며, 결정이 구체화될 때 `CONTEXT.md`와 `ADR`을 업데이트합니다. 기술 문서 작성, 제품 감각이 필요한 엔지니어링, 그리고 프롬프트만으로 브레인스토밍하는 것보다 레포 기반의 언어가 더 중요한 모든 워크플로에 적합합니다.

ubiquitous-language는 대화에서 공통 용어집을 추출하고, 애매한 용어와 동의어를 표시하며, UBIQUITOUS_LANGUAGE.md를 작성하는 DDD 스타일 스킬입니다. 도메인 용어를 정의하고, 팀 간 인식을 맞추며, Technical Writing의 ubiquitous-language를 개선하는 데 사용하세요.

python-code-style은 Python 포매팅, 린팅, 네이밍, 타입 힌트, docstring 작성 기준을 정리하는 데 도움을 줍니다. pull request 리뷰, 팀 컨벤션 표준화, 그리고 `pyproject.toml`에서 ruff, mypy, pyright 관련 가이드를 설정할 때 유용합니다.

architecture-decision-records는 팀이 맥락, 결정 내용, 대안, 결과를 명확히 담은 ADR을 작성하고 지속적으로 관리할 수 있도록 도와, 오래 활용할 수 있는 기술 의사결정 문서를 만드는 데 유용합니다.

changelog-automation 스킬은 팀이 Keep a Changelog, SemVer, 릴리스 노트, Conventional Commits를 바탕으로 변경 이력 워크플로를 설계하도록 돕습니다. 설치 전에 적용 맥락을 검토하고, 사용 입력값을 정의하며, Technical Writing 및 개발자 문서에서 릴리스 노트의 일관성을 높이는 데 활용할 수 있습니다.

add-educational-comments 스킬은 지정한 코드 파일의 구조와 동작을 유지하면서 학습용 주석을 추가합니다. 대상 파일이 없으면 파일 지정을 요청할 수 있고, 읽는 사람의 수준에 맞춰 설명 밀도를 조정하며, 교육용 코드 편집에 맞는 명확한 라인 증가 제한을 따릅니다.

gws-docs는 gws CLI를 통해 Google Docs를 읽고 쓸 수 있게 해 주며, 생성, 가져오기, 배치 업데이트를 메서드 수준에서 제어할 수 있습니다. 기술 문서 작성과 문서 자동화를 위해 gws-docs 가이드의 설치, 스키마, 사용 흐름을 따르세요.

adr-skill은 에이전트가 실행 가능한 Architecture Decision Records를 팀이 작성하고 지속적으로 관리할 수 있도록 돕습니다. ADR 초안 작성, ADR 폴더 초기 구성, 템플릿 선택, 상태 업데이트, 체크리스트·스크립트·예시를 활용한 의사결정 검증까지 지원합니다.

Clarify는 혼란스러운 UX 카피, 오류 메시지, 라벨, 온보딩 단계, 안내 문구를 더 명확하게 다듬어 사용자가 덜 추측하고 바로 행동할 수 있게 해줍니다. Technical Writing, 지원 콘텐츠, 그리고 인터페이스 문구를 더 분명하게 만들어야 하는 제품팀에 특히 유용합니다. 이 스킬은 문구를 고치기 전에 맥락, 대상 사용자, 현재 사용자 상태부터 파악하므로 결과가 더 직관적이고 구체적이며 실제 사용에 도움이 되는 방향으로 정리됩니다.