Cover image for Your AI Agent Shouldn't Start From Zero Every Session

Your AI Agent Shouldn't Start From Zero Every Session

ysskrishna profile photoysskrishna
3 min read

You open a new chat. The model is bright, eager, and completely unaware of how your project works.

So you paste the same instructions again:

  • the tone you want,
  • the folders it should avoid,
  • your team’s naming conventions,
  • the commands it must run before calling a task “done.”

It works until the next session, when you type it again.

What an agent skill actually is

The idea is surprisingly simple. At its core, a skill is usually just a small folder containing instructions, metadata, and optional helper scripts. Instead of re-explaining your workflow every session, you package it once and let the agent reuse it automatically.

The open standard is documented at Agent Skills, originally developed around Anthropic’s tooling ecosystem and increasingly adopted elsewhere.

Browse on skills.sh, install with the CLI

skills.sh is a catalog (the .sh is just the domain name). You search by workflow, skim categories, and copy an install line from a listing.

Installation is usually the Skills CLI from vercel-labs/skills. Listings point at a Git repo; you pass that URL to npx skills add, name the skill with --skill when the repo ships more than one.

What gets loaded (and when)

An agent does not dump every installed skill into the context window immediately. That would waste tokens and overwhelm the model.

Instead, skills usually work through a form of progressive disclosure:

  1. The agent scans lightweight skill descriptions first.
  2. It determines which skills are relevant to the task.
  3. Only the matching skill gets loaded into active context.

The surface differs by product, but the pattern is the same: install once, reuse across sessions. See your tool’s docs, for example Cursor, Claude Code, VS Code Agent Skills, and Anthropic’s overview.

Project skills vs personal skills

Project skills (architecture, CI, PR conventions) usually live in the repo so the team shares them.

Personal skills (how you debug, summarize, or write) are yours across projects, often installed globally.

Example: install Six Thinking Hats

A concrete install using my curated repo and the six-thinking-hats skill (structured multi-angle reasoning):

npx skills add https://github.com/ysskrishna/ai-agent-skills --skill six-thinking-hats -g

npx skills add always writes to the shared global directory:

~/.agents/skills

Compatible agents can read that path automatically.

Pick your agents

To also mirror the skill into a tool’s native skills folder (e.g. Claude Code’s ~/.claude/skills), choose it under Additional agents in the installer. That creates extra installs for the tools you select, not only ~/.agents/skills.

Skills CLI prompt: choose agents, shared ~/.agents/skills vs optional per-tool paths

Then pick an installation method. I use Symlink when it is offered: one copy on disk, simpler updates. Copy to all agents duplicates files into each tool’s tree if you prefer that layout.

Skills CLI prompt: installation method, Symlink recommended vs copy to all agents

If you live in VS Code, the skills-sh extension on Open VSX exposes the same catalog from the sidebar.

Trust

Treat skills like browser extensions: skim the repo, see what commands or scripts they run, and try them in a throwaway folder first. Instruction-only packs and script-heavy ones both deserve a quick audit before -y.

Takeaway

The win is not a smarter model in the abstract. It is less time re-onboarding every chat. Pick one real annoyance on skills.sh, install it once, run one task, and notice what you stop typing.

Further reading

You might also like

Explore All Blogs