Write Connector Agent Skill

by langchain-ai

Add a new built-in OpenWiki source connector. Use when a user asks to create or implement an OpenWiki connector.

593 tokens

context cost

the whole folder, loaded on every use

files

instructions only

copies elsewhere

how many repositories repackaged it

14057

stars on the repo

on the repository, not the skill itself

Install

one command, takes just this skill from the repository

npx skills add https://github.com/langchain-ai/openwiki --skill write-connector

The instruction itself

5 sections, as written by the author

Write An OpenWiki Connector

OpenWiki connectors are built-in TypeScript modules in the OSS repository. Do not create a plugin marketplace, dynamic connector package, or runtime-loaded untrusted connector. Add normal source files and tests.

Required Shape

Add the connector to src/connectors/types.ts and src/connectors/registry.ts.
Implement the connector under src/connectors/sources/<connector>.ts.
The connector must expose a ConnectorRuntime with id, displayName, description, backend, requiredEnv, supportsAgenticDiscovery, and ingest().
Ingestion writes raw JSON/manifests under ~/.openwiki/connectors/<id>/raw/<run-id>/.
State lives in ~/.openwiki/connectors/<id>/state.json.
Config lives in ~/.openwiki/connectors/<id>/config.json.
Secrets live in ~/.openwiki/.env and are referenced only by env var name.

Security Rules

Never read, print, log, return, or hardcode secret values.
Do not store credentials in connector config, raw files, state, logs, or tests.
Validate connector IDs and raw file paths so reads and writes stay inside ~/.openwiki/connectors/<id>/.
Use deterministic ingestion code for credentialed external fetching.
If wrapping MCP, treat the MCP server as read-only and call only allowlisted read/dump operations from connector config.
Do not let untrusted connector manifests instantiate arbitrary commands or arbitrary network endpoints without explicit built-in code review.

Ingestion Rules

Git/local repos should write compact manifests and let the agent inspect the local repo as the source of truth.
Sources with timestamps should store per-stream cursors.
Sources with object metadata should store IDs, last edited timestamps, and content hashes.
Sources with pagination should store enough state to continue without refetching everything.
Raw dumps should preserve source IDs, timestamps, URLs, authors, and enough provenance for citations.

User-Facing Finish

When done, tell the user:

which connector files changed,
which env vars to set in ~/.openwiki/.env,
what config file to create or edit,
how to run openwiki personal --update to trigger ingestion,
which scopes/permissions the source provider requires.

Other skills for the same job

different authors, same section of the catalogue

Protocolsio Integration

by christophacham

×4

Integration with protocols.io API for managing scientific protocols. This skill should be used when working with protocols.io to search, create, update, or publish protocols; manage protocol steps and materials; handle discussions and comments; organize workspaces; upload and manage files; or integrate protocols.io functionality into workflows. Applicable for protocol discovery, collaborative protocol development, experiment tracking, lab protocol management, and scientific documentation.

16k tokens

Tailored Resume Generator

by frostant

×4

Analyzes job descriptions and generates tailored resumes that highlight relevant experience, skills, and achievements to maximize interview chances

3k tokens

Excalidraw Diagram Generator

by github

vendor ×3

Generate Excalidraw diagrams from natural language descriptions. Use when asked to "create a diagram", "make a flowchart", "visualize a process", "draw a system architecture", "create a mind map", or "generate an Excalidraw file". Supports flowcharts, relationship diagrams, mind maps, and system architecture diagrams. Outputs .excalidraw JSON files that can be opened directly in Excalidraw.

Build and distribute Expo development clients locally or via TestFlight

Use when you have a written implementation plan to execute in a separate session with review checkpoints

Data structure for annotated matrices in single-cell analysis. Use when working with .h5ad files or integrating with the scverse ecosystem. This is the data format skill—for analysis workflows use scanpy; for probabilistic models use scvi-tools; for population-scale queries use cellxgene-census.

16k tokens

Benchling Integration

by christophacham

×3

Benchling R&D platform integration. Access registry (DNA, proteins), inventory, ELN entries, workflows via API, build Benchling Apps, query Data Warehouse, for lab data management automation.

Comprehensive molecular biology toolkit. Use for sequence manipulation, file parsing (FASTA/GenBank/PDB), phylogenetics, and programmatic NCBI/PubMed access (Bio.Entrez). Best for batch processing, custom bioinformatics pipelines, BLAST automation. For quick lookups use gget; for multi-service integration use bioservices.

24k tokens

How to use it

Copy the folder

Take langchain-ai/write-connector from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.