스킬 워크숍 Plugin

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

<workspace>/skills/<skill-name>/SKILL.md

• 메모리는 사실, 선호도, 엔터티, 과거 컨텍스트를 저장합니다.
• Skills는 에이전트가 향후 작업에서 따라야 할 재사용 가능한 절차를 저장합니다.
• 스킬 워크숍은 유용한 턴을 안전성 검사와 선택적 승인을 거쳐 지속 가능한 워크스페이스 스킬로 이어주는 다리입니다.

• 외부에서 가져온 애니메이션 GIF 에셋을 검증하는 방법
• 스크린샷 에셋을 교체하고 치수를 확인하는 방법
• 저장소별 QA 시나리오를 실행하는 방법
• 반복되는 제공자 실패를 디버그하는 방법
• 오래된 로컬 워크플로 노트를 복구하는 방법

• “사용자가 파란색을 좋아한다” 같은 사실
• 광범위한 자전적 메모리
• 원본 트랜스크립트 보관
• 비밀, 자격 증명, 숨겨진 프롬프트 텍스트
• 반복되지 않을 일회성 지침

​

기본 상태

• Plugin이 옵트인 테스트와 내부 실사용에 충분한 수준으로 지원됩니다.
• 제안 저장 방식, 리뷰어 임계값, 캡처 휴리스틱은 발전할 수 있습니다.
• 보류 승인이 권장 시작 모드입니다.
• 자동 적용은 신뢰할 수 있는 개인/워크스페이스 설정용이며, 공유되었거나 적대적 입력이 많은 환경용이 아닙니다.

​

활성화

{
  plugins: {
    entries: {
      "skill-workshop": {
        enabled: true,
        config: {
          autoCapture: true,
          approvalPolicy: "pending",
          reviewMode: "hybrid",
        },
      },
    },
  },
}

• skill_workshop 도구를 사용할 수 있습니다.
• 명시적인 재사용 가능 수정 사항이 보류 제안으로 대기열에 추가됩니다.
• 임계값 기반 리뷰어 패스가 스킬 업데이트를 제안할 수 있습니다.
• 보류 제안이 적용되기 전까지는 어떤 스킬 파일도 작성되지 않습니다.

{
  plugins: {
    entries: {
      "skill-workshop": {
        enabled: true,
        config: {
          autoCapture: true,
          approvalPolicy: "auto",
          reviewMode: "hybrid",
        },
      },
    },
  },
}

​

구성

// Conservative: explicit tool use only, no automatic capture.
{
  autoCapture: false,
  approvalPolicy: "pending",
  reviewMode: "off",
}

// Review-first: capture automatically, but require approval.
{
  autoCapture: true,
  approvalPolicy: "pending",
  reviewMode: "hybrid",
}

// Trusted automation: write safe proposals immediately.
{
  autoCapture: true,
  approvalPolicy: "auto",
  reviewMode: "hybrid",
}

// Low-cost: no reviewer LLM call, only explicit correction phrases.
{
  autoCapture: true,
  approvalPolicy: "pending",
  reviewMode: "heuristic",
}

​

캡처 경로

​

도구 제안

​

휴리스틱 캡처

• next time
• from now on
• remember to
• make sure to
• always ... use/check/verify/record/save/prefer
• prefer ... when/for/instead/use
• when asked

• 애니메이션 GIF 작업 -> animated-gif-workflow
• 스크린샷 또는 에셋 작업 -> screenshot-asset-workflow
• QA 또는 시나리오 작업 -> qa-scenario-workflow
• GitHub PR 작업 -> github-pr-workflow
• 대체값 -> learned-workflows

​

LLM 리뷰어

• 최근 트랜스크립트 텍스트, 마지막 12,000자로 제한
• 기존 워크스페이스 스킬 최대 12개
• 각 기존 스킬에서 최대 2,000자
• JSON 전용 지침

• disableTools: true
• toolsAllow: []
• disableMessageTool: true

{
  "action": "create",
  "skillName": "media-asset-qa",
  "title": "Media Asset QA",
  "reason": "Reusable animated media acceptance workflow",
  "description": "Validate externally sourced animated media before product use.",
  "body": "## Workflow\n\n- Verify true animation.\n- Record attribution.\n- Store a local approved copy.\n- Verify in product UI before final reply."
}

​

제안 수명 주기

• id
• createdAt
• updatedAt
• workspaceDir
• 선택적 agentId
• 선택적 sessionId
• skillName
• title
• reason
• source: tool, agent_end, 또는 reviewer
• status
• change
• 선택적 scanFindings
• 선택적 quarantineReason

• pending - 승인 대기 중
• applied - <workspace>/skills에 작성됨
• rejected - 운영자/모델이 거부함
• quarantined - 치명적 스캐너 발견 사항으로 차단됨

<stateDir>/skill-workshop/<workspace-hash>.json

​

도구 참조

skill_workshop

​

status

{ "action": "status" }

{
  "workspaceDir": "/path/to/workspace",
  "pending": 1,
  "quarantined": 0,
  "applied": 3,
  "rejected": 0
}

​

list_pending

{ "action": "list_pending" }

{ "action": "list_pending", "status": "applied" }

• pending
• applied
• rejected
• quarantined

​

list_quarantine

{ "action": "list_quarantine" }

​

inspect

{
  "action": "inspect",
  "id": "proposal-id"
}

​

suggest

{
  "action": "suggest",
  "skillName": "animated-gif-workflow",
  "title": "Animated GIF Workflow",
  "reason": "User established reusable GIF validation rules.",
  "description": "Validate animated GIF assets before using them.",
  "body": "## Workflow\n\n- Verify the URL resolves to image/gif.\n- Confirm it has multiple frames.\n- Record attribution and license.\n- Avoid hotlinking when a local asset is needed."
}

{
  "action": "suggest",
  "apply": true,
  "skillName": "animated-gif-workflow",
  "description": "Validate animated GIF assets before using them.",
  "body": "## Workflow\n\n- Verify true animation.\n- Record attribution."
}

{
  "action": "suggest",
  "apply": false,
  "skillName": "screenshot-asset-workflow",
  "description": "Screenshot replacement workflow.",
  "body": "## Workflow\n\n- Verify dimensions.\n- Optimize the PNG.\n- Run the relevant gate."
}

{
  "action": "suggest",
  "skillName": "qa-scenario-workflow",
  "section": "Workflow",
  "description": "QA scenario workflow.",
  "body": "- For media QA, verify generated assets render and pass final assertions."
}

{
  "action": "suggest",
  "skillName": "github-pr-workflow",
  "oldText": "- Check the PR.",
  "newText": "- Check unresolved review threads, CI status, linked issues, and changed files before deciding."
}

​

apply

{
  "action": "apply",
  "id": "proposal-id"
}

quarantined proposal cannot be applied

​

reject

{
  "action": "reject",
  "id": "proposal-id"
}

​

write_support_file

• references/
• templates/
• scripts/
• assets/

{
  "action": "write_support_file",
  "skillName": "release-workflow",
  "relativePath": "references/checklist.md",
  "body": "# Release Checklist\n\n- Run release docs.\n- Verify changelog.\n"
}

​

Skill 쓰기

<workspace>/skills/<normalized-skill-name>/

• 소문자로 변환
• [a-z0-9_-]가 아닌 연속 문자는 -가 됨
• 앞뒤의 영숫자가 아닌 문자는 제거
• 최대 길이는 80자
• 최종 이름은 [a-z0-9][a-z0-9_-]{1,79}와 일치해야 함

• Skill이 없으면 Skill Workshop이 새 SKILL.md를 작성합니다
• 이미 있으면 Skill Workshop이 본문을 ## Workflow에 추가합니다

• Skill이 있으면 Skill Workshop이 요청한 섹션에 추가합니다
• 없으면 Skill Workshop이 최소 Skill을 만든 다음 추가합니다

• Skill이 이미 있어야 합니다
• oldText가 정확히 존재해야 합니다
• 첫 번째 정확한 일치 항목만 교체됩니다

​

안전 모델

• scanFindings를 유지합니다
• quarantineReason을 유지합니다
• list_quarantine에 표시됩니다
• apply를 통해 적용할 수 없습니다

​

프롬프트 지침

• 사실/선호가 아니라 절차
• 사용자 수정 사항
• 명확하지 않지만 성공한 절차
• 반복되는 함정
• 추가/교체를 통한 오래되었거나 얕거나 잘못된 Skill 복구
• 긴 도구 루프나 어려운 수정 후 재사용 가능한 절차 저장
• 짧은 명령형 Skill 텍스트
• transcript 덤프 금지

• 보류 모드: 제안을 대기열에 넣고, 명시적 승인 후 apply 사용
• 자동 모드: apply: false로 대신 대기열에 넣지 않는 한 안전한 작업 영역 Skill 업데이트 적용

​

비용 및 런타임 동작

• 사용할 수 있을 때 동일하게 구성된 제공자/모델 컨텍스트를 사용합니다
• 런타임 에이전트 기본값으로 대체됩니다
• reviewTimeoutMs를 가집니다
• 경량 부트스트랩 컨텍스트를 사용합니다
• 도구가 없습니다
• 직접 아무것도 쓰지 않습니다
• 일반 스캐너와 승인/격리 경로를 거치는 제안만 내보낼 수 있습니다

​

운영 패턴

• “다음에는 X를 해”
• “이제부터는 Y를 선호해”
• “Z를 확인하도록 해”
• “이것을 워크플로로 저장해”
• “이건 시간이 좀 걸렸으니, 과정을 기억해”
• “이것에 대한 로컬 Skill을 업데이트해”

## Workflow

- Verify the GIF URL resolves to `image/gif`.
- Confirm the file has multiple frames.
- Record source URL, license, and attribution.
- Store a local copy when the asset will ship with the product.
- Verify the local asset renders in the target UI before final reply.

The user asked about a GIF and I searched two websites. Then one was blocked by
Cloudflare. The final answer said to check attribution.

• transcript 형태임
• 명령형이 아님
• 시끄러운 일회성 세부 정보 포함
• 다음 에이전트에게 무엇을 해야 하는지 알려 주지 않음

​

디버깅

openclaw plugins list --enabled

{ "action": "status" }

{ "action": "list_pending" }

{ "action": "list_quarantine" }

• skill-workshop: queued <skill>
• skill-workshop: applied <skill>
• skill-workshop: quarantined <skill>
• skill-workshop: heuristic capture skipped: ...
• skill-workshop: reviewer skipped: ...
• skill-workshop: reviewer found no update

​

QA 시나리오

• qa/scenarios/plugins/skill-workshop-animated-gif-autocreate.md
• qa/scenarios/plugins/skill-workshop-pending-approval.md
• qa/scenarios/plugins/skill-workshop-reviewer-autonomous.md

pnpm openclaw qa suite \
  --scenario skill-workshop-animated-gif-autocreate \
  --scenario skill-workshop-pending-approval \
  --concurrency 1

pnpm openclaw qa suite \
  --scenario skill-workshop-reviewer-autonomous \
  --concurrency 1

​

자동 적용을 활성화하지 말아야 할 때

• 작업 영역에 민감한 절차가 포함되어 있음
• 에이전트가 신뢰할 수 없는 입력을 처리 중임
• Skills가 광범위한 팀에서 공유됨
• 아직 프롬프트나 스캐너 규칙을 조정 중임
• 모델이 적대적인 웹/이메일 콘텐츠를 자주 처리함

​

관련 문서

• Skills
• Plugins
• 테스트