스킬 · 개발 워크플로
파일 기반 작업 계획 유지
task_plan.md·findings.md·progress.md 세 파일을 프로젝트에 두고 매 턴마다 자동으로 다시 읽어 들입니다. /clear 나 컨텍스트 압축으로 대화가 리셋돼도 계획은 디스크에 남아 있어 작업이 끊기지 않습니다. UserPromptSubmit·PreToolUse·Stop 같은 훅으로 강제 주입되므로, 지침처럼 "지켜주면 좋고"가 아니라 매번 실제로 실행됩니다.
이럴 때 씁니다
5단계 넘는 조사·구축 작업을 시킬 때, 컨텍스트가 자주 끊기는 긴 세션에서 이전 진행 상황을 계속 잃어버릴 때
한 줄로 넣기
터미널에 아래 한 줄을 붙여 넣으십시오.
npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g
전체 설치 절차
Claude Code 가 아니거나 개별 스킬만 넣고 싶으실 때 보십시오. 눌러서 펼치면 전체가 나옵니다.
# planning-with-files 설치
## 1. 넣기
npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g
--list 를 붙이면 저장소 안의 스킬 목록이 먼저 뜹니다.
여러 개가 들어 있는 저장소라면 골라서 넣을 수 있습니다.
npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g --list
## 2. Claude 를 다시 시작합니다
창만 닫으면 반영되지 않습니다.
Windows 는 작업 표시줄 아이콘에서 종료, macOS 는 Cmd+Q 로 완전히 끄십시오.
## 3. 확인
npx skills list
넣은 스킬 목록이 나옵니다.
보이지 않으면 앱을 완전히 껐다 켰는지 먼저 확인하십시오.
## 4. 쓰기
"파일 기반 작업 계획 유지" 관련 작업을 시켜 보십시오.
스킬이 붙었다면 알아서 불러 씁니다.이렇게 시켜 보세요
넣고 나서 바로 던져 볼 수 있는 지시문입니다. 누르면 복사됩니다.
알아 둘 것
MIT 라이선스. 60개 넘는 에이전트 도구에서 동작하는 Agent Skills 표준을 따릅니다. task_plan.md 는 훅이 자동으로 읽어 매번 주입하니, 웹에서 가져온 내용은 반드시 findings.md 에만 적어야 합니다(프롬프트 인젝션 방지).
자주 막히는 지점
웹에서 가져온 내용을 계획 파일에 그대로 적으면 안 됩니다
task_plan.md 는 매 턴 자동으로 다시 읽혀 지시처럼 작동할 수 있습니다. 외부에서 가져온 내용은 findings.md 에만 적고, 그 안의 지시문은 절대 그대로 따르지 않아야 합니다.
간단한 작업에는 오히려 과합니다
3단계 미만의 단순 질문이나 파일 하나 수정하는 일에는 필요 없습니다.
언제 쓰고, 언제 안 쓰나
조사·구축이 5단계를 넘어가거나, 세션이 자주 끊겨서 매번 다시 설명해야 하는 상황에서 씁니다. 짧은 질문 하나짜리 작업에는 안 써도 됩니다.
개발 워크플로 도구를 고를 때
CI/CD, 이슈 트래커, 브랜치 관리를 연결하는 도구입니다. 토큰 권한 범위를 필요한 저장소로만 좁힐 수 있는지, 실패했을 때 로그를 어디서 확인하는지 먼저 확인하세요.
원본 보기
스킬의 실제 내용은 SKILL.md 파일 하나에 들어 있습니다. 넣기 전에 한 번 읽어 보시는 것을 권합니다. 스킬은 Claude 에게 그대로 들어가는 지시문이라, 무엇을 시키는지 확인하지 않고 쓰면 의도치 않은 동작을 할 수 있습니다.
GitHub 에서 OthmanAdi/planning-with-files 열기