librarian

Research open-source library internals and generate GitHub permalinks for code evidence.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/mpsuesser/workspace --skill librarian-mpsuesser
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: librarian
Source: https://github.com/mpsuesser/workspace/tree/main/dotconfig/pi/agent/extensions/web/skills/librarian
Command: npx skills add https://github.com/mpsuesser/workspace --skill librarian-mpsuesser

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you answer questions about how open-source libraries work by locating the exact source code evidence and linking it to permanent GitHub citations.

Core Features & Use Cases

  • Evidence-backed research: Produces answers grounded in actual library code with GitHub permalinks to precise lines.
  • Request-aware strategy: Selects the right workflow for conceptual usage, implementation details, or historical “why it changed” questions.
  • Implementation and permalink workflows: Clones repositories, searches for identifiers, inspects files, derives commit SHAs, and constructs stable blob links.

Quick Start

Ask: "Explain how [library] implements [feature] and cite the exact source lines from GitHub permalinks."

Frequently Asked Questions about librarian

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get GitHub permalinks to exact source lines explaining how an open-source library works?

To get GitHub permalinks for open-source library research, the Skill clones repositories, searches for identifiers, inspects files, and resolves commit SHAs to construct stable blob links for every code-related claim. It generates verifiable citations pointing to precise lines.

How can I find out why a specific behavior changed in a repository's git log?

To find why behavior changed in a repository's git log, the Skill uses a request-aware workflow to research historical context. It inspects commit history and source files, then extracts evidence with verifiable GitHub permalinks to show exactly what implementation lines were modified.

What is the best way to do an implementation deep dive on an open-source project?

The best way to do an implementation deep dive is using a workflow that targets conceptual usage and implementation details. It clones the repository, searches for specific identifiers, inspects files, and generates stable GitHub blob links to cite the exact source lines.

Can I get code-cited answers for conceptual usage questions in open-source repos?

Yes, you can get code-cited answers for conceptual usage questions. The Skill selects a request-aware strategy to research open-source repos, extracting evidence from specific files and lines to produce answers grounded in actual library code with permanent GitHub citations.

Does source inspection for repo research require any external dependencies?

No, source inspection for repo research requires no external dependencies. The Skill handles the entire process internally by sequentially executing tools to clone repositories, resolve commit SHAs, and construct verifiable GitHub permalinks for implementation analysis.

Limitations of using automated permalinks for code citation?

A limitation of using automated permalinks for code citation is that the Skill relies on sequential tool execution, repo cloning, and code search. It requires resolving commit SHAs to construct stable blob links, meaning it targets open-source repositories and specific files rather than private codebases.