Restructure the entire documentation site following the Diátaxis framework (Learn / How-to / Understand / Reference) with new content across 110 files. ## Information Architecture (M1) - Move all docs to Diátaxis directory structure (learn/, how-to/, understand/, reference/) - Add client-redirects plugin for old URL compatibility - Rewrite sidebar, navbar, and footer to match new IA - Update all internal cross-references ## Homepage + Quickstarts (M2) - Add scenario entry cards to homepage with hand-drawn design - 5 quickstart pages: Claude Code, GitHub Copilot (with copy mode recommendation), Codex, Multiple Tools, Dev Containers, Playground ## Blog + Changelog (M3) - Enable Docusaurus blog plugin with authors.yml - 5 blog posts: 5-min tutorial, managing 50+ skills, skillshare vs vercel/skills comparison, team sharing patterns, write your first skill - Static /changelog page from CHANGELOG.md ## Recipes + Philosophy (M4) - 5 recipe pages: CI/CD validation, enterprise skills, project setup, cross-machine sync, team onboarding - 3 philosophy pages: why-local-first, security-first, sync-modes-explained ## Content Polish - Cross-validate all content against CLI source (19 inaccuracies fixed) - Lowercase "skillshare" throughout (avoid brand conflict with Skillshare Inc.) - Add registry.yaml to file structure and Key Paths docs - Highlight multi-platform git support (GitHub, GitLab, Bitbucket, Gitea, Azure DevOps, AtomGit, Codeberg) - Standardize brew install command - Add AsciinemaPlayer component (cast recordings pending)
7.1 KiB
sidebar_position
| sidebar_position |
|---|
| 4 |
log
View persistent operations and audit logs for debugging and compliance.
skillshare log # Interactive TUI (default on TTY)
skillshare log --audit # Show only audit log
skillshare log --tail 50 # Show last 50 entries
skillshare log --cmd sync # Show only sync entries
skillshare log --status error # Show only errors
skillshare log --since 2d # Entries from last 2 days
skillshare log --json # Output as JSONL
skillshare log --no-tui # Plain text output
skillshare log --clear # Clear operations log
skillshare log -p # Project operations + audit logs
When to Use
- Browse and filter log entries interactively
- Debug what happened during a failed operation
- Review the audit trail for compliance or troubleshooting
- Filter logs by command, status, or time range for investigation
Interactive TUI
On a TTY, skillshare log launches an interactive terminal UI with:
- Fuzzy filtering — type to filter by timestamp, command, status, source, or detail content
- Keyboard navigation — arrow keys to browse,
qto quit - Detail panel — shows full timestamp, command, status, duration, source, and structured args for the selected entry
- Merged view — operations and audit entries are merged and sorted by time when viewing both
Use --no-tui to skip the TUI and print plain text instead:
skillshare log --no-tui # Plain text output
skillshare log --no-tui | less # Pipe to pager manually
What Gets Logged
Every mutating CLI and Web UI operation is recorded as a JSONL entry with timestamp, command, status, duration, and contextual args.
| Command | Log File |
|---|---|
install, uninstall, sync, push, pull, collect, backup, restore, update, target, trash, config |
operations.log |
audit |
audit.log |
Web UI actions that call these APIs are logged the same way as CLI operations.
Log Types
Default View
Shows both sections in one output:
- Operations log
- Audit log
skillshare log
Audit-Only View
Records security audit scans separately from normal operations.
skillshare log --audit
Filtering
Narrow results by command, status, or time range. When --cmd targets a specific log (e.g. --cmd audit only appears in audit.log), the irrelevant section is automatically skipped.
skillshare log --cmd install # Only install entries
skillshare log --status error # Only errors
skillshare log --since 1h # Last hour (also: 30m, 2d, 1w)
skillshare log --since 2026-01-15 # Since a specific date
skillshare log --cmd sync --status error # Combine filters
JSON Output
Output raw JSONL for scripting and automation:
skillshare log --json # All entries as JSONL
skillshare log --json --cmd sync # Filtered JSONL
Example Output (Plain Text)
When using --no-tui or in a non-TTY environment:
┌─ skillshare log ────────────────────────────────────┐
│ Operations (last 2) │
│ mode: global │
│ file: ~/.local/state/skillshare/logs/operations.log │
└─────────────────────────────────────────────────────┘
TIME | CMD | STATUS | DUR
-----------------+-----------+---------+--------
2026-02-10 14:31 | SYNC | error | 0.8s
targets: 3
failed: 1
scope: global
2026-02-10 14:35 | SYNC | ok | 0.3s
targets: 3
scope: global
┌─ skillshare log ────────────────────────────────────┐
│ Audit (last 1) │
│ mode: global │
│ file: ~/.local/state/skillshare/logs/audit.log │
└─────────────────────────────────────────────────────┘
TIME | CMD | STATUS | DUR
-----------------+-----------+---------+--------
2026-02-10 14:36 | AUDIT | blocked | 1.1s
scope: all-skills
scanned: 12
passed: 11
failed: 1
failed skills:
- prompt-injection-skill
- data-exfil-skill
Log Format
Entries are stored in JSONL format (one JSON object per line):
{"ts":"2026-02-10T14:30:00Z","cmd":"install","args":{"source":"anthropics/skills/pdf"},"status":"ok","ms":1200}
| Field | Description |
|---|---|
ts |
ISO 8601 timestamp |
cmd |
Command name |
args |
Command-specific context (source, name, target, etc.) |
status |
ok, error, partial, or blocked |
msg |
Error message (when status is not ok) |
ms |
Duration in milliseconds |
Log Location
~/.local/state/skillshare/logs/operations.log # Global operations
~/.local/state/skillshare/logs/audit.log # Global audit
<project>/.skillshare/logs/operations.log # Project operations
<project>/.skillshare/logs/audit.log # Project audit
Track Logs In Git (Project Mode)
Project mode ignores .skillshare/logs/ by default to avoid noisy commits.
If your team wants to version log files, add these user override rules in .skillshare/.gitignore after the managed block:
# User override: track logs
!logs/
!logs/*.log
If your repository root .gitignore also ignores .skillshare/, add matching unignore rules there as well.
Options
| Flag | Description |
|---|---|
-a, --audit |
Show only audit log |
-t, --tail <N> |
Show last N entries (default: 20) |
--cmd <name> |
Filter by command name (e.g. sync, install, audit) |
--status <status> |
Filter by status (ok, error, partial, blocked) |
--since <dur|date> |
Filter by time (30m, 2h, 2d, 1w, or 2006-01-02) |
--json |
Output raw JSONL (one JSON object per line) |
--no-tui |
Disable interactive TUI, use plain text output |
-c, --clear |
Clear selected log file (operations by default, audit with --audit) |
-p, --project |
Use project-level log |
-g, --global |
Use global log |
-h, --help |
Show help |
Web UI
The log is also available in the web dashboard at /log:
skillshare ui
# Navigate to Log page
The Log page provides:
- Tabs for
All,Operations, andAudit - Filters for command, status, and time range (1h, 24h, 7d, 30d)
- Table view with time, command, details, status, and duration
- Audit detail rows showing failed/warning skill names when present
- Clear and Refresh controls