whatisgithub

What is skillsense?

jampez77/skillsense — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 2/5Setup · moderate

In one sentence

A local tool that quietly reminds AI coding agents like Claude Code or Codex which of your installed skills and tools are relevant to your current prompt.

Mindmap

mindmap
  root((SkillSense))
    What it does
      Scores prompt against local skills
      Injects a short reminder
      Stays silent if no match
    Why it exists
      Skill recall problem
      Too many skills to scan
      Weaker answers without it
    How it works
      Local deterministic matching
      No LLM or embeddings
      No API key
    Supported agents
      Claude Code
      OpenAI Codex
    Tech stack
      Node.js
      TypeScript
      Built-in SQLite

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Get an automatic reminder of an already-installed skill relevant to your current Claude Code or Codex prompt

USE CASE 2

Index your locally installed skills, commands, agents, and MCP servers for fast local search

USE CASE 3

Manually test which installed capability matches a query with the search command

USE CASE 4

Avoid reinventing a workflow by hand when a matching skill already exists but wasn't picked up

What is it built with?

TypeScriptNode.jsSQLite

How does it compare?

jampez77/skillsense0xradioac7iv/tempfs52191314/web-agent-proxy-sdk
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity2/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Node.js 22.5 or newer, then a clone, install, build, and npm link to get the CLI on your PATH.

The README excerpt does not state a license for this project.

So what is it?

SkillSense is a small tool that runs alongside AI coding agents like Claude Code and OpenAI Codex. It does not replace them, and it does not add new abilities to them. Instead, right before each of your prompts is processed, it quietly checks whether you already have a relevant skill, command, agent, MCP server, project rule, or instruction file installed locally, and if so, it reminds the agent that this capability exists and where to find it. The problem it targets is not that these agents cannot use installed skills. Both Claude Code and Codex already support automatically picking up a skill's name and short description when deciding what to use, without you having to type an explicit command. The issue is recall: as a person installs more skills, commands, and rules over time, the model has more and more metadata to silently scan on every turn, and it can simply miss the right one, giving a weaker answer or making you redo work by hand that a skill already covered. SkillSense answers one question automatically before each prompt: are there any installed capabilities that look materially relevant right now. It works entirely on your machine. When a prompt is submitted, SkillSense scores your locally indexed capabilities against it using local, deterministic matching, keyword and tag overlap plus a text-similarity method called BM25, with no large language model call, no embeddings, and no API key involved. If nothing scores highly enough, it stays silent. If exactly one capability matches well, it adds a single short line naming it and where it lives. If more than one matches, it lists them and leaves the choice to you rather than guessing. A SkillSense failure is designed to never block your prompt from going through. The README also explains that Claude Code's own built-in skill recall has limits: descriptions loaded into context are capped at roughly one percent of the context window, and past that budget, least-used skills get truncated or dropped, which is the situation SkillSense's reminder is meant to help with. SkillSense needs Node.js 22.5 or newer and uses Node's built-in local database module for storage, so no native compilation or extra database is required. It integrates with Claude Code and Codex through plugin hooks, and is installed by cloning the repository, running npm install and npm run build, then linking the command line tool onto your path.

Copy-paste prompts

Prompt 1
Walk me through installing SkillSense and linking it onto my PATH
Prompt 2
Explain how SkillSense decides when to show a capability reminder versus staying silent
Prompt 3
Help me set up SkillSense's Claude Code plugin hook
Prompt 4
Explain the difference between SkillSense's matching and Claude Code's built-in implicit skill activation

Frequently asked questions

What is skillsense?

A local tool that quietly reminds AI coding agents like Claude Code or Codex which of your installed skills and tools are relevant to your current prompt.

What language is skillsense written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, SQLite.

What license does skillsense use?

The README excerpt does not state a license for this project.

How hard is skillsense to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is skillsense for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.