Skip to content

Add dedicated 'type: local' source for local codebase skills #238

@yusufkaraaslan

Description

@yusufkaraaslan

Problem

Currently, creating skills from local codebases requires using type: "github" with local_repo_path, which is confusing:

{
  "sources": [{
    "type": "github",  // Misleading - not actually GitHub!
    "local_repo_path": "/path/to/local/repo",
    "repo": "dummy/value"  // Required but meaningless
  }]
}

Proposed Solution

Add clean type: "local" source with dedicated parameters:

{
  "sources": [{
    "type": "local",
    "directory": "/path/to/local/repo",
    "name": "my-project",
    "description": "My local project",
    "code_analysis_depth": "deep",
    "enable_codebase_analysis": true,
    "ai_mode": "auto"
  }]
}

Implementation Requirements

  1. Config Schema: Add type: "local" to ConfigValidator
  2. CLI Shortcut: skill-seekers local --directory ./my_project
  3. UnifiedScraper: Add _scrape_local() method
  4. Documentation: Update guides and examples
  5. Tests: Add local source tests

Benefits

  • Clear intent (local analysis, not GitHub)
  • No dummy repo parameter needed
  • Better CLI ergonomics
  • Consistent with other source types

Priority

Medium - Improves UX but current workaround exists

Related

  • Built on C3.5 (Architectural Overview & Skill Integrator)
  • Uses C3.x codebase analysis features
  • Complements existing GitHub/docs/PDF sources

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestroadmap:H1.3Roadmap task H1.3: Create example project folder

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions