SkillKit Documentation

repository·main·Indexed 23 days ago

https://github.com/rohitg00/skillkit

A package manager for AI agent skills that allows developers to install, translate, and manage skills across 46 different AI agents, such as Claude Code, Cursor, and Copilot. SkillKit provides a CLI for project-aware skill recommendations, security scanning for prompt and command injection, session memory management, and the ability to sync project context across multiple agents.

Tokens
149.3K
Snippets
381
Records
1K
Agent score
79%

What's inside SkillKit

  1. Browse the SkillKit Community Skills Registry

    main
    The SkillKit Community Skills Registry is a curated collection of community-contributed skills designed for AI coding agents. These skills provide specialized knowledge and workflows across various domains such as Code Quality, Frontend, DevOps, Security, and AI/ML. You can use these skills to augment your agent's capabilities in specific technical areas.
  2. Overview of SkillKit TUI Screens

    main

    The TUI provides several specialized screens for managing your agent skills and workflows:

    • Home: Dashboard with stats, detected agents, and features.
    • Browse: Search and explore skill repositories.
    • Marketplace: Curated skill marketplace with popularity metrics.
    • Recommend: AI-powered suggestions based on your project.
    • Installed: Manage installed skills (enable/disable/remove).
    • Sync: Sync skills across multiple agents.
    • Translate: Convert skills between agent formats.
    • Workflow: Manage and execute automation workflows.
    • Execute: Run skills with checkpoints.
    • Plan: Structured plan creation and execution.
    • Team: Share skills and bundles with team members.
    • Context: View detected stack and project context.
    • Memory: Session memory and learnings.
    • Plugins: Plugin management.
    • Methodology: Development methodology frameworks.
    • Settings: Configure SkillKit preferences.
  3. Understand Mesh Security Levels

    main

    The mesh network supports different security profiles depending on your environment:

    LevelDiscoveryTransportAuthUse Case
    developmentopennonenoneLocal dev
    signedsignedoptionaloptionalTrusted LAN
    secure (default)signedrequiredrequiredProduction
    stricttrusted-onlyrequiredmTLSHigh security
  4. Understand Design Levels

    main

    Design can be applied at different granularities depending on the scope of the task:

    • High-Level Design (Architecture): Focuses on system components, interactions, data flow, technology choices, and deployment architecture.
    • Mid-Level Design (Module/Component): Focuses on class/module structure, interfaces, contracts, state management, and error handling strategies.
    • Low-Level Design (Implementation): Focuses on algorithm details, specific data structures, method signatures, and edge case handling.
  5. How SkillKit translation works

    main

    SkillKit uses a central SKILL.md (Universal Format) as the intermediary. The translation flow follows this path:

    1. Universal Format (SKILL.md)
    2. Adapter Interface
    3. Agent-Specific Formats

    To implement a new adapter, the interface requires two methods:

    • getConfigPath(): Returns the skill directory.
    • generateConfig(): Converts the content into the target format.
  6. How Trust Badges are determined

    main

    Skills display trust badges based on their source and a quality analysis performed by the TrustScorer.

    Badge Types

    • [Official]: Published by a known official source (e.g., Anthropic, Vercel, iii-hq).
    • [Trusted]: TrustScorer rates the skill 8-10.
    • [Review]: TrustScorer rates the skill 5-7.
    • [Caution]: TrustScorer rates the skill 0-4.

    TrustScorer Dimensions

    The score is a weighted composite of four dimensions:

    1. Clarity (30%): Purpose and instruction definition.
    2. Boundaries (25%): Adherence to declared scope.
    3. Specificity (25%): Actionability of instructions.
    4. Safety (20%): Absence of dangerous patterns (injection, exfiltration, secrets).
  7. Use Task Decomposition to break down complex work

    main

    The task-decomposition skill is used when a project, feature, or research task feels too large to manage. The core principle is to break work down into small, atomic units that are independently completable, verifiable, and should ideally take no more than a few hours to finish.

    This skill is triggered by phrases such as:

    • "break down"
    • "decompose"
    • "split into tasks"
    • "too big"
    • "where to start"
    • "complex task"
  8. How the Chrome Extension works

    main

    The extension follows a specific pipeline to convert web content into agent-ready skills:

    1. Data Collection: The Popup reads the current tab's URL and title using the activeTab permission. No content script injection is required.
    2. Processing: The Background service worker sends the URL to the SkillKit API (skillkit.sh/api/save-skill or agenstskills.com/api/save-skill).
      • The server fetches the page and converts HTML to markdown using Turndown.
      • GitHub URLs are automatically converted to raw content.
      • Tags are generated using a weighted 5-source analysis (URL segments, headings, code blocks, keywords, and language).
    3. Delivery: The service worker receives the SKILL.md and uses the chrome.downloads API to save the file to your disk.

    Note on Privacy: The extension only sends the page URL to the server. It does not send page content, browsing history, or personal data. Selection-based saves are performed entirely locally in the browser.

  9. How the Memory System works

    main

    SkillKit's memory system follows an Observation → Learning Pipeline to convert AI session patterns into reusable skills:

    1. Observations: Tracks patterns during sessions (e.g., tool use, errors, solutions).
    2. Compression: Distills these observations into reusable learnings.
    3. Injection: Loads relevant learnings into new sessions to provide context.
    4. Export: Converts learnings into shareable skills.

    Progressive Disclosure (Token Optimization)

    To minimize token usage, the system uses a 3-layer retrieval model. It starts with the lightest layer and fetches deeper layers only as needed based on relevance and your token budget:

    LayerContent~Tokens
    IndexTitles, tags, timestamps50-100
    TimelineContext, excerpts, activity~200
    DetailsFull content, metadata500-1000
  10. Memory Categories and Tiers in @skillkit/mcp-memory

    main

    Memories in @skillkit/mcp-memory are organized by categories and tiers to facilitate efficient retrieval and lifecycle management.

    Categories

    • fact: Factual information
    • decision: Decisions made
    • preference: User preferences
    • pattern: Observed patterns
    • insight: Derived insights
    • reasoning: Reasoning chains

    Tiers

    • warm: Recent, frequently accessed memories
    • long: Consolidated long-term memories

    Lifecycle: Memories are automatically promoted from warm to long based on access count, reinforcement score, and age.

  11. Understand TUI visual indicators and status icons

    main

    The TUI uses specific visual cues to communicate skill quality and status.

    Quality Grades

    Skills are graded based on their score:

    • A (90-100): Green
    • B (80-89): Green
    • C (70-79): Yellow
    • D (60-69): Red
    • F (Below 60): Red

    Status and Agent Icons

    • : Enabled
    • : Disabled
    • : Claude Code
    • : Cursor
    • : Codex
    • : Gemini
    • : OpenCode