7 new integration tests covering:
- trash agents empty / delete
- uninstall agents in project mode (fix: wire kind into project dispatch)
- check all (combined skill + agent)
- sync agents skips targets without agent path
- list all --json verifies kind field on every entry
- status agents --json with target details
Total agent tests: 45 (38 + 7).
Add Config.HasAgentTarget() helper that checks if any configured target
has an agents path set.
handler_install: append warning to install summary when agents are
installed but no targets support them.
handler_sync: after sync completes, check if agents exist in source
but no targets have agent paths — add warning to response.
handler_skills list: read agent metadata directly via os.ReadFile
instead of install.ReadMeta (which appends subdirectory). Fixes agents
showing as 'local' instead of 'github'.
handler_skills detail: strip .md from URL param before agent lookup.
Fixes 'skill not found: content-marketer.md' error.
handler_skills: use time.RFC3339 instead of hardcoded format string.
ResourcesPage: use FileText icon for agents, Folder for skills.
SkillPickerModal: use items-start + mt-1.5 on checkbox/radio to align
with first line of multi-line content (name + path).
handler_install: summary message uses 'agents' when kind is agent,
instead of always saying 'skills'.
Backend (install_discovery.go):
- Add discoverAgents() call to all 3 subdir discovery paths (sparse
checkout, GitHub API, full clone fallback). Previously only whole-repo
discovery detected agents.
Frontend (InstallForm.tsx):
- Single-skill fast path now checks hasAgents before auto-installing.
When agents exist alongside a single skill, falls through to the
kind selector instead of silently installing as skill.
Backend (handler_install.go):
- handleInstallBatch checks body.Kind field; when 'agent', uses
InstallAgentFromDiscovery() writing to agentsSource() instead of
skills source directory.
Frontend (client.ts):
- installBatch accepts optional kind param.
Frontend (InstallForm.tsx):
- handleBatchInstall detects kind from selected items and passes
kind='agent' to the API when installing agents.
Backend (handler_install.go):
- handleDiscover now returns agents[] alongside skills[] with kind field
- needsSelection true when agents are present
Frontend (client.ts):
- Add DiscoveredAgent type and agents field to DiscoverResult
Frontend (InstallForm.tsx):
- Mixed repo: show kind selector dialog (Skills/Agents buttons)
- Pure agent repo: map agents to skill picker format directly
- After kind selection, open existing SkillPickerModal with filtered items
Spec/design/tasks updated with kind-first selection decision.
Replace SegmentedControl with proper underline tab pattern:
- nav[role=tablist] with button[role=tab][aria-selected]
- 3px bottom border indicator, semibold text, count badge pill
- Gap-6 spacing between tabs for breathing room
Playful theme enhancements:
- Wavy SVG border-image for the tab bar bottom border (dark mode variant)
- Active tab count badge inverts to pencil bg + paper text
- Wobble border-radius on count badge via --radius-wobble-badge
Clean theme: minimal underline with pencil color active state.
Replace raw button underline tabs with ss-segmented + ss-segmented-item
classes. This hooks into the existing playful theme CSS which applies
wobbly border-radius, hard offset shadows, and pencil-colored active
state — matching the hand-drawn aesthetic of other segmented controls.
Uses non-connected variant (gap between buttons) to visually
distinguish from the sub-filter pills below.
Use underline tab pattern for Skills/Agents primary navigation:
- Border-bottom indicator on active tab (pencil color)
- Icon + label + count for each tab
- Sits between page header and sticky toolbar
- Clear visual hierarchy: underline tabs (primary) vs pill filters (secondary)
Removes the connected SegmentedControl that was visually identical
to the sub-filters, causing hierarchy confusion.
Move resource type toggle into the sticky toolbar row alongside the
view toggle. Use connected + size='md' SegmentedControl matching the
grid/folder/table view toggle design (icon + text label, white active
background, shared border container).
Removes the separate tab section above the toolbar — both controls
now live in the same horizontal bar for a cleaner, more compact layout.
Rename SkillsPage.tsx to ResourcesPage.tsx. Page title changed to
'Resources' with subtitle showing both skill and agent counts.
Add top-level SegmentedControl tabs (Skills | Agents) for switching
between resource types. Each tab has its own count badge. Sub-filters
(All/Tracked/GitHub/Local) apply within the active tab.
Tab selection persists via ?tab=agents URL param. Dashboard stat cards
link to /resources and /resources?tab=agents.
Route: /resources is the primary path; /skills kept as alias.
Nav sidebar: 'Skills' → 'Resources' with Layers icon.
Keyboard shortcut 's' → /resources.
Tour updated for resource-oriented language.
Command pages updated (7 files):
- list: 'skillshare list agents', [A] badge
- install: --kind agent, -a flag, auto-detection
- sync: agent sync with all three modes, supported targets
- check: 'skillshare check agents' drift detection
- audit: 'skillshare audit agents'
- enable: --kind agent routes to .agentignore
- uninstall: --kind agent flag
Getting started updated:
- first-sync: link to agents concepts in What's Next
- quick-reference: agent management command table + agents source path
Commands index: added agents row to What do you want to do table.
7 integration tests covering:
- install --kind flag parsing and validation
- install -a flag parsing
- check agents with empty dir, local agent, and JSON output
- enable/disable --kind agent routing to .agentignore
- uninstall --kind agent flag parsing
installTrackedRepoImpl: discover agents alongside skills after clone.
Report agent count in warnings. Update empty-repo warning to account
for repos that have only agents.
updateTrackedRepo: discover agents after git pull, report count.
Add RepoURL field to AgentCheckResult. Add EnrichAgentResultsWithRemote()
that batches remote HEAD hash checks via ParallelCheckURLs and marks
agents as 'update_available' when remote has newer commits than the
installed version.
list_tui_item: show [A] badge prefix for agents in terminal list view.
list.go: add Kind field to skillEntry and skillJSON structs.
SyncPage: add kind badge to diff items using DiffTarget.items.kind.
AuditPage: add kind badge to audit result cards.
UpdatePage: add kind badge to update result items.
SkillPickerModal: add kind badge in skill picker.
client.ts: add kind to DiffTarget items and AuditResult types.
handler_sync: add Kind field to diff stream item struct.
handler_audit: add Kind field to audit stream result.
handler_check: add Kind field to check stream result.
handler_update: add Kind field to update stream result.
handler_install: add Kind field to install request for agent support.
check: add parseKindArg() for 'skillshare check agents'. When agents
kind selected, runs CheckAgents() on agents source dir and displays
per-agent status (up_to_date/drifted/local/error). Supports --json.
uninstall: add --kind flag to parseUninstallArgs and parseKindFlag()
in cmdUninstall dispatch. Kind stored in uninstallOptions for
agent-specific uninstall routing.
SkillDetailPage: import KindBadge, show kind badge (S/A) next to skill
name in the detail header.
audit: add parseKindArg() for 'skillshare audit agents' syntax. Kind
filter parsing ready, actual agent-only filtering to be wired.
handler_skills: skill detail endpoint falls back to agents source when
skill not found. Returns agent .md file content and kind='agent'.
project_reconcile: add ReconcileProjectAgents() to scan agents source,
update registry with kind='agent' entries, and batch-update
.skillshare/.gitignore for agent files and metadata.
TrashPage: add KindBadge next to trashed item names with 'skill'
fallback for old trash items without kind field.
enable.go: support --kind agent flag to route enable/disable operations
to .agentignore instead of .skillignore. Works in both global and project
modes. Oplog entries now include kind field.
TargetsPage.tsx: show agent path below skill path when target has
agentPath. Display agent linked count alongside skill counts.
DashboardPage: add Agents stat card with Bot icon and accent color,
linking to /skills?kind=agent.
SkillsPage: add Skills/Agents filter tabs alongside existing filters.
KindBadge displayed on each skill card. matchFilter supports kind-based
filtering with accurate filter counts.
handler_collect: add kind field to localSkillItem response.
handler_uninstall: add kind field to batch request and result structs.
status: show agents source path and agent count alongside skills source.
doctor: add checkAgentsSource() health check verifying agents source
directory exists, is a directory, and reports agent count. Non-existent
dir is info (not error) since agents are optional.
handler_trash: add kind field to trashItemJSON for frontend badge.
Add agentsSource() helper to Server for mode-aware agent directory
resolution (global: EffectiveAgentsSource, project: .skillshare/agents).
handler_overview: add agentCount field counting .md files in agents dir.
handler_skills: add kind field ("skill"/"agent") to skillItem response.
Support ?kind= query param filter. List agents from agents source dir
alongside skills, with metadata enrichment from per-agent meta files.
handler_targets: add agentPath, agentLinkedCount, agentExpectedCount
fields to targetItem for frontend agent path display.
Add ReadAgentIgnoreMatcher() in skillignore package to read .agentignore
and .agentignore.local files using the same gitignore-style pattern
format as .skillignore.
Integrate .agentignore filtering into AgentKind.Discover() with both
directory-level CanSkipDir() and file-level Match() checks.
Add agent validation in internal/validate/:
- AgentFile(): extension check, filename restrictions (no spaces/special
chars), file size warning (>100KB), existence and type checks
- AgentName(): name format validation (alphanumeric + hyphens/underscores)
9 new tests across resource and validate packages.
Add kind_filter.go with two parsing strategies:
- parseKindArg(): positional syntax (list agents, sync skills)
- parseKindFlag(): flag syntax (uninstall --kind agent tutor)
resourceKindFilter type with IncludesSkills()/IncludesAgents() helpers
for handler-level routing. Supports singular and plural forms
(skill/skills, agent/agents).
16 test cases covering both parsers and filter logic.
Add SyncAgents() dispatcher supporting all three sync modes:
- merge: per-file symlinks with local file preservation
- symlink: whole directory symlink to agent source
- copy: file copy with content-diff detection
Add CheckAgentCollisions() to detect agents that flatten to the same
filename from different subdirectories.
Add PruneOrphanAgentLinks() for merge mode and PruneOrphanAgentCopies()
for copy mode to clean up stale agent files in targets.
Add CollectAgents() to copy non-symlinked .md files from target back
to agent source directory.
18 tests covering all modes, collision detection, pruning, and collect.
Rename SkillEntry to ResourceEntry with type alias for backward compat.
All 56 call sites continue to compile without changes.
Add LoadUnifiedRegistry() to merge separate skills and agents registry
files for global mode (skills/registry.yaml + agents/registry.yaml).
Agent entries automatically get Kind="agent" during merge.
Add SaveSplitByKind() to split a unified registry back by kind for
persisting to the correct source directory. Skips writing agents
registry file when no agent entries exist.
Add AgentsSource field to Config struct with EffectiveAgentsSource()
method that defaults to ~/.config/skillshare/agents when not set.
Global init now creates agents source directory alongside skills source.
Project init creates .skillshare/agents/ alongside .skillshare/skills/.
projectRuntime gains agentsSourcePath field for project-mode agent ops.
Update config.schema.json with agents_source property definition.