Overview
AI 에이전트에게 블로그 작성을 맡기는 것은 단순히 글을 대신 쓰게 하는 것이 아닙니다. 기술 블로그는 창의성만큼이나 **‘규격(Convention)’**이 중요하며, 파일명 규칙 하나만 틀려도 CI/CD 배포는 무참히 실패합니다.
본 가이드는 유튜브 강의 **[Harness Engineering 안티그래비티에 클로드 스킬 적용하기]**의 이론을 실전 블로그 프로젝트에 적용한 사례를 다룹니다. 특히 안티그래비티 환경에서 **‘스킬(Skill)’**이라는 정교한 엔진이 어떻게 에이전트의 사고를 제어하여 완벽한 기술 포스팅을 생산하는지 그 뒷이야기를 상세히 기술합니다.
Background / Problem: AI에게 ‘창의성’만 맡길 수 없는 이유
범용 AI 모델인 클로드(Claude)나 GPT를 그대로 블로그 포스팅에 사용하면 다음과 같은 고질적인 문제에 직면합니다.
- 배포 불안정성 (Build Failure):
YAML Front-matter의 콜론(:) 띄어쓰기 한 칸만 어긋나도 Hugo 빌드는 중단됩니다. AI는 이런 사소하지만 치명적인 규격을 매번 스스로 방어하지 못합니다. - 포맷의 파편화 (Fragmentation): 필진마다 글의 깊이가 다르고, 핵심 정보(Troubleshooting)가 누락되는 등 일관된 품질 유지가 어렵습니다.
- 컨텍스트 오버헤드: 매번 “7,000자 이상 써라”, “H1 대신 H2를 써라"는 지시를 반복해야 하며, 이는 곧 막대한 토큰 낭비로 이어집니다.
이러한 수동 관리의 한계를 극복하고, 에이전트에게 영구적인 전문 지식을 주입하는 ‘스킬(Skill)’ 시스템이 필요했습니다.
Solution / Implementation: 스킬 시스템의 기술적 정수와 작동 원리
NSoft America는 영상에서 강조된 프로그레시브 디스클로저(Progressive Disclosure) 기술을 기반으로 블로그 작성 전용 스킬인 hugo-blog-writer를 구축했습니다.
1. 스킬의 물리적 엔진 구성
스킬은 단순한 설명서가 아니라 에이전트가 해석하는 **‘논리 알고리즘’**입니다.
| 엔진 분류 | 역할 | 블로그 프로젝트 적용 사례 |
|---|---|---|
| Rule Engine | 필수 규격 강제 | YAML 형식 강제, draft: false 설정 확인 |
| Constraint Engine | 품질 보증 | 최소 7,000자 이상 서술, 시각적 요소 의무화 |
| Workflow Engine | 배포 가이드 | hugo new부터 git push까지의 단계적 위임 |
2. 가용성을 극대화하는 ‘프로그레시브 디스클로저’
영상의 핵심 강의 내용처럼, 안티그래비티 에이전트는 스킬 파일을 한꺼번에 읽지 않습니다.
- 스캐닝(Scanning): 스킬 폴더의
YAML Front-matter내description만 읽어 존재 여부를 결정합니다. - 필요 시 로드: 사용자가 “블로그 글 써줘"라고 말하는 **결정적 순간(Moment of Decision)**에만 전체 매뉴얼을 로드합니다.
- 효과: 이를 통해 토큰 사용량을 혁신적으로 줄이면서도, 에이전트가 정말 필요한 전문 지식에만 집중하게 만듭니다.
3. 실전! 스킬(Skill)을 활용한 에이전트 통제술
스킬이 준비되었다면 이제 에이전트에게 집필을 맡길 차례입니다. 단순히 “글 써줘"라고 하는 대신, 스킬의 존재를 명확히 상기시키며 다음과 같이 요청해 보세요.
“지정한
.agents/skills/hugo-blog-writer스킬의 ‘Gold Standard’ 규격을 엄격히 준수해서, [주제/영상 링크]를 바탕으로 기술 블로그 초안을 작성해줘.”
- 구조적 초안 생성: 에이전트는 스킬에 정의된 6단계 섹션(Overview-Background-Solution…)을 뼈대로 삼아 글의 논리 구조를 자동으로 설계합니다.
- 배포 규격 자가 검증:
YAML Front-matter형식, 날짜(date), 가중치(weight) 등 배포 실패를 유발하는 치명적 요소들을 스킬의 지침에 따라 스스로 체크하며 작성합니다. - 반복 업무의 제로화: “레퍼런스에서 (Optional) 표기를 빼줘"와 같은 세세한 스타일 가이드까지 스킬에 녹아있다면, 추가 지시 없이도 매번 완벽한 결과물을 산출합니다.
심화: 문제 해결 및 주의사항 (Troubleshooting)
블로그 전용 스킬을 활용하여 글을 작성할 때 마주할 수 있는 기술적 함정과 해결 방법입니다.
⚠️ 실전 체크리스트 (Common Mistakes)
| 오류 상황 | 원인 | 해결 방법 |
|---|---|---|
| 스킬이 활성되지 않음 | 폴더명 오타 및 단수형 | .agents/skills/ 폴더명이 정확한지, SKILL.md가 존재하는지 확인 |
| 스킬 규격 위반 | 에이전트의 기억 상실 | “방금 적용된 스킬의 핵심 규칙 3가지를 요약해봐"라고 질문하여 컨텍스트 리프레시 |
| 날짜 이슈로 글 사라짐 | 미래 시점 날짜 설정 | 스킬 내 **‘날짜 조정 전략’**을 통해 수동으로 과거 날짜를 부여하도록 가이드 |
FAQ: 스킬 기반 작성 실전 Q&A (Frequently Asked Questions)
Q1. 스킬을 적용했는데도 에이전트가 자꾸 예전 방식으로 글을 써요.
에이전트가 스킬을 제대로 로드했는지 view_file 로그를 확인해 보세요. 만약 로드했는데도 말을 듣지 않는다면, “현재 워크스페이스의 hugo-blog-writer 스킬을 다시 읽고(Read again), 그 기준에 맞춰서 다시 리팩토링해줘"라고 강하게 지시하는 것이 좋습니다.
Q2. 여러 개의 스킬이 충돌할 때는 어떻게 하나요?
안티그래비티는 보통 모든 스킬을 참고하려 합니다. 특정 스킬의 지침이 가장 중요하다면 프롬프트에 “다른 규칙보다 .agents/skills/hugo-blog-writer 내의 ‘Gold Standard’ 섹션 규격을 최우선으로 적용해줘"라고 우선순위를 명시해 주세요.
Key Takeaways
- Efficiency: 프로그레시브 디스클로저로 토큰 사용량을 90% 이상 절감했습니다.
- Standardization: 모든 필진이 동일한 ‘스킬 매뉴얼’을 공유하여 글의 품질을 균일화했습니다.
- Automation:
hugo new부터 배포까지의 모든 워크플로우를 에이전트에게 안전하게 위임했습니다.
References
마치며
NSoft AI 에이전트의 블로그 작성 스킬은 단순한 ‘자동 글쓰기’를 넘어, 팀의 운영 노하우를 ‘디지털 자산’으로 전환한 것입니다. 하니스 엔지니어링의 철학이 녹아든 이 스킬 시스템을 통해, 우리는 더 이상 형식의 늪에 빠지지 않고 오직 ‘기술적 통찰력’ 그 자체를 전달하는 데 집중할 수 있게 되었습니다.