Skill

bip

by majiayu000

AI Summary

Bip is a CLI tool for managing academic references with local-first search capabilities and integration with external paper discovery services. It benefits researchers and developers who need to organize, search, and explore scientific literature efficiently.

Install

# Add to your project root as SKILL.md
curl -o SKILL.md "https://raw.githubusercontent.com/majiayu000/claude-skill-registry/main/skills/data/bip/SKILL.md"

Description

Unified guidance for using the bipartite reference library CLI. Use when searching for papers, managing the library, or exploring literature via S2/ASTA.

Bip Reference Library

A CLI tool for managing academic references with local storage and external paper search. Repository: Configured via nexus_path in ~/.config/bip/config.json

⚠️ CRITICAL: Local-First Search Policy

ALWAYS search locally before using external APIs. NEVER call ASTA without explicit user permission. The nexus library has ~6000 papers. Most relevant papers are already there.

Required Search Order

• Local search FIRST (always do this): `bash bip search "author keyword" ` • If bip search fails (e.g., schema error), rebuild the database: `bash bip rebuild --force ` Then retry the search. • Only if not found locally AND user confirms, use ASTA: ` "I couldn't find that paper in the local library. Would you like me to search Semantic Scholar (ASTA)?" ` DO NOT call bip asta, mcp__asta__*, or any external API without asking first.

Argument Handling

When invoked with arguments like /bip find <query> or /bip <query>: • Always search local library first with bip search "<query>" • If local search fails with an error, rebuild the database and retry • Only after exhausting local options, ask user if they want to search externally • For title searches, use the full title; for topic searches, use key terms

Quality Score

C

Acceptable

67/100

Standard Compliance45
Documentation Quality62
Usefulness58
Maintenance Signal100
Community Signal92
Scored Yesterday

GitHub Signals

Stars100
Forks15
Issues1
UpdatedYesterday
View on GitHub

Trust & Transparency

Open Source — MIT

Source code publicly auditable

Verified Open Source

Hosted on GitHub — publicly auditable

Actively Maintained

Last commit Yesterday

100 stars — Growing Community

15 forks

My Fox Den

Community Rating

Works With

Claude Code