Skip to content

[EPIC] Skills Index Registry - O(1) Skill Lookup and Governance #581

@rjmurillo-bot

Description

@rjmurillo-bot

Overview

Implement a Skills Index Registry to enable O(1) skill lookup by ID, establish consistent naming conventions, and provide skill lifecycle governance.

Problem Statement

  • 65+ skill-related memory files in .serena/memories/
  • Skill discovery requires O(n) linear search across 100+ files
  • ~7 new skills added per day (scaling problem)
  • No consistent naming convention or governance

Solution

A central registry (skills-index.md) that:

  1. Provides single-read skill lookup by ID
  2. Groups skills by domain for browsing
  3. Establishes skill ID naming convention
  4. Defines skill lifecycle (creation → validation → deprecation)

Functional Requirements

ID Requirement
FR-1 skills-index.md in .serena/memories/
FR-2 Quick reference table with Skill ID, Domain, Statement, File, Status
FR-3 Domain grouping with markdown headings
FR-4 Deprecated skills section
FR-5 Skill ID naming convention (Skill-{Domain}-{NNN})
FR-6 Skill lifecycle governance

User Stories

  1. Agent finds skill by ID in one memory read
  2. Retrospective agent prevents duplicate skill IDs
  3. Planner discovers related skills by domain
  4. Skillbook agent identifies deprecated patterns
  5. Quality gate validates naming convention

Artifacts

Sub-Tasks

  • Create skills-index.md with initial skill inventory
  • Establish skill ID naming convention documentation
  • Create skill lifecycle governance process
  • Validate existing skills against naming convention
  • Create automation for skill registration

Effort: 8-12 hours (implementer)

Metadata

Metadata

Assignees

Labels

agent-explainerDocumentation agentagent-implementerCode implementation agentagent-memoryContext persistence agentagent-plannerMilestone and work package agentagent-retrospectiveLearning extraction agentagent-roadmapProduct vision agentagent-skillbookAuto-created by AI triagearea-skillsSkills documentation and patternsarea-workflowsGitHub Actions workflowsautomationAutomated workflows and processesdocumentationImprovements or additions to documentationenhancementNew feature or requestpriority:P1Important: Affects user experience significantly, high business valueskill-catalogAuto-created by AI triage

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions