본문으로 건너뛰기

status

skillshare의 현재 상태(source, tracked repository, target, 버전)를 표시합니다.

skillshare status

사용 시점​

  • 변경 사항을 적용한 후 모든 target이 sync 상태인지 확인
  • 어떤 target에 sync 실행이 필요한지 확인
  • tracked repo가 최신 상태인지 확인
  • 활성 audit policy(profile, threshold, dedupe mode)를 확인
  • CLI 또는 skill 업데이트 여부 확인

status demo

출력 예시​

Source
✓ ~/.config/skillshare/skills (12 skills, 2026-01-20 15:30)
→ .skillignore: 5 patterns, 2 skills ignored
✓ ~/.config/skillshare/agents (8 agents, 2026-01-20 15:30)

Tracked Repositories
_team-skills    ✓  5 skills, up-to-date
_personal-repo  !  3 skills, has uncommitted changes

Targets
claude
  skills   merged       [merge] ~/.claude/skills (8 shared, 2 local)
  agents   merged       [merge] 8/8 linked
cursor
  skills   merged       [merge] ~/.cursor/skills (3 shared, 0 local)
  agents   merged       [merge] 8/8 linked
windsurf
  skills   has files    [merge->needs sync] ~/.windsurf/skills
⚠ 2 skill(s) not synced — run 'skillshare sync'

Extras
rules        has files  [merge] .cursor/rules (4 files)
commands     has files  [merge] .claude/commands (3 files)

Audit
→ Profile:    DEFAULT
→ Block:      severity >= CRITICAL
→ Dedupe:     GLOBAL
→ Analyzers:  ALL

Version
✓ CLI: 0.17.0
✓ Skill: 0.17.0 (up to date)

섹션​

Source​

source 디렉터리 위치, skill 개수, 마지막 수정 시간을 표시합니다. agent가 구성되어 있으면 agent source가 별도 줄에 표시됩니다.

Tracked Repositories​

--track으로 설치된 git repository를 나열합니다. 다음을 표시합니다.

  • repository별 skill 개수
  • git 상태(up-to-date 또는 변경 사항 있음)

Targets​

각 target은 skills와 agents에 대한 하위 항목을 가진 헤더로 표시됩니다.

claude
  skills   merged       [merge] ~/.claude/skills (8 shared, 2 local)
  agents   merged       [merge] 8/8 linked

skills 하위 항목은 다음을 표시합니다.

  • Sync mode: merge, copy, 또는 symlink
  • Path: target 디렉터리 위치
  • Status: merged, copied, linked, has files, 또는 needs sync
  • Shared/local 개수: merge와 copy mode에서는 해당 target의 expected set(include/exclude filter 적용 후)을 기준으로 개수를 계산합니다. copy mode는 "shared" 대신 "managed"를 표시합니다.

agents 하위 항목은 다음을 표시합니다.

  • Status: synced 또는 drift
  • Linked 개수: 예) 8/8 linked

agent source가 존재하지 않거나 target에 agent path가 구성되어 있지 않으면 agents 하위 항목은 생략됩니다.

Status의미
mergedskill/agent가 개별적으로 symlink됨
copiedskill이 실제 파일로 복사됨(manifest 포함)
linked전체 디렉터리가 symlink됨
has files아직 sync되지 않음
needs syncmode가 변경됨, 적용하려면 sync 실행
drift일부 agent가 누락됨 — sync agents 실행

Extras​

extras가 구성되어 있으면 각 extra의 sync 상태를 표시합니다.

Extras
rules        has files  [merge] .cursor/rules (4 files)
commands     has files  [merge] .claude/commands (3 files)

각 항목은 이름, 상태, sync mode, target 경로, file 개수를 표시합니다.

Audit​

활성 audit policy 구성(CLI flag, project config, 또는 global config에서 resolve됨)을 표시합니다.

  • Profile: DEFAULT, STRICT, 또는 PERMISSIVE
  • Block: 차단을 위한 severity threshold(기본값 CRITICAL)
  • Dedupe: 중복 제거 mode(GLOBAL 또는 LEGACY)
  • Analyzers: 활성화된 analyzer(ALL 또는 필터링된 목록)

Version​

CLI와 skill 버전을 최신 릴리스와 비교합니다. (Global mode 전용.)

옵션​

Flag설명
--jsonJSON으로 출력(scripting/CI용)
--project, -pproject mode 사용
--global, -gglobal mode 사용
--help, -h도움말 표시

JSON 출력​

skillshare status --json
{
  "source": {
    "path": "~/.config/skillshare/skills",
    "exists": true,
    "skillignore": {
      "active": true,
      "files": [".skillignore", "_team-skills/.skillignore"],
      "patterns": ["test-*", "vendor/"],
      "ignored_count": 2,
      "ignored_skills": ["test-draft", "vendor/lib"]
    }
  },
  "skill_count": 12,
  "tracked_repos": [
    {"name": "_team-skills", "skill_count": 5, "dirty": false},
    {"name": "_personal-repo", "skill_count": 3, "dirty": true}
  ],
  "targets": [
    {
      "name": "claude",
      "path": "~/.claude/skills",
      "mode": "merge",
      "status": "merged",
      "synced_count": 8,
      "include": [],
      "exclude": []
    }
  ],
  "agents": {
    "source": "~/.config/skillshare/agents",
    "exists": true,
    "count": 8,
    "targets": [
      {"name": "claude", "path": "~/.claude/agents", "expected": 8, "linked": 8, "drift": false}
    ]
  },
  "audit": {
    "profile": "DEFAULT",
    "threshold": "CRITICAL",
    "dedupe": "GLOBAL",
    "analyzers": []
  },
  "version": "0.17.0"
}

source.skillignore 필드는 .skillignore 또는 .skillignore.local file이 하나 이상 존재할 때만 나타납니다. 없을 경우: "skillignore": { "active": false }. files 배열은 존재하는 경우 .skillignore.local 경로를 포함합니다. text mode에서는 .skillignore.local이 적용 중이면 source 줄에 .local active가 표시됩니다.

JSON 출력은 global mode와 project mode 모두에서 지원됩니다.

Project Mode​

project 디렉터리에서는 status가 project 관련 정보를 표시합니다. 첫 번째 섹션 헤더에 Source (project)가 표시되어 project mode임을 나타냅니다.

skillshare status        # .skillshare/가 존재하면 자동 감지
skillshare status -p     # 명시적 project mode

출력 예시​

Source (project)
✓ .skillshare/skills/ (3 skills, 2026-04-08 12:43)
→ .skillignore: 3 patterns, 0 skills ignored
✓ .skillshare/agents/ (4 agents, 2026-04-08 12:43)

Targets
claude
  skills   merged       [merge] .claude/skills (3 shared, 0 local)
  agents   merged       [merge] 4/4 linked
cursor
  skills   merged       [merge] .cursor/skills (3 shared, 0 local)
  agents   merged       [merge] 4/4 linked

Extras
rules        has files  [merge] .cursor/rules (4 files)
commands     has files  [merge] .claude/commands (3 files)

Audit
→ Profile:    DEFAULT
→ Block:      severity >= CRITICAL
→ Dedupe:     GLOBAL
→ Analyzers:  ALL

Project status는 Tracked Repositories나 Version 섹션을 표시하지 않습니다(이들은 global 전용 기능입니다).

참고​