CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

langchain-architecture

Design LLM applications using LangChain 1.x and LangGraph for agents, memory, and tool integration. Use when building LangChain applications, implementing AI agents, or creating complex LLM workflows.

54

Quality

68%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/llm-application-dev/skills/langchain-architecture/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

53%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The skill's strongest asset is its fully executable Quick Start agent example and a well-signaled, real reference file. Its weaknesses are a padded Core Concepts section that explains things Claude already knows plus an inline generic math-evaluator utility, and the absence of any sequenced build workflow with validation checkpoints.

Suggestions

Cut the 'Core Concepts' bullet lists and the inline AST math evaluator; replace tool examples with short domain-relevant stubs so every line teaches LangChain/LangGraph usage.

Move version-sensitive claims (package list with '1.2.x', 'standard in 2026') into a clearly labeled 'Package layout / version notes' or deprecated section, or drop the date framing.

Restructure around a sequenced build flow (init model -> define state -> wire tools -> add checkpointer -> invoke -> verify tool calls) and move Testing and Performance sections into references/details.md, keeping SKILL.md as the navigation tier.

Fix non-runnable snippets: import os in the pooling example and define or stub text_splitter/embeddings in the batch-processing example.

DimensionReasoningScore

Conciseness

The 'Core Concepts' section spends many bullets restating knowledge Claude already has (e.g., 'StateGraph: Explicit state management with typed state', 'Memory: Short-term and long-term memory across sessions', 'Document Loaders: Load from various sources'), and the Quick Start embeds a ~30-line AST math evaluator that is generic Python unrelated to LangChain. Time-sensitive claims ('langchain (1.2.x)', 'LangGraph is the standard for building agents in 2026') also appear outside any deprecated/old-patterns section, matching anchor 2 ('noticeably verbose; several unnecessary explanations or padded sections') rather than the mostly-efficient anchor 3.

2 / 5

Actionability

The Quick Start is complete, runnable code (create_react_agent with @tool definitions, MemorySaver checkpointer, thread_id config), and the testing, caching, and pooling sections give concrete snippets — matching 'mostly executable guidance with minor gaps'. It falls short of level 5 because later snippets reference undefined names (text_splitter and embeddings in the batch section, os.environ without importing os), so they are not copy-paste ready.

4 / 5

Workflow Clarity

The document is organized topically (concepts, quick start, testing, performance) rather than as a sequenced build workflow; the Quick Start implies an order (init LLM, define tools, checkpointer, create agent, invoke) but no validation or verification checkpoints are stated, matching anchor 3 ('sequence present but checkpoints missing or implicit'). This is not the simple single-action skill exception, so it cannot score 5.

3 / 5

Progressive Disclosure

There is a single, clearly signaled, one-level-deep reference ('Detailed pattern documentation lives in references/details.md. Read that file when the navigation tier above is insufficient.') and the referenced file exists with substantive worked examples. However, the Testing Strategies and Performance Optimization sections are additional tiers of detail that arguably belong in the reference file, matching anchor 4 ('good structure; most content appropriately placed; minor organization gaps') rather than the cleanly split level 5.

4 / 5

Total

13

/

20

Passed

Description

70%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A solid description that answers both what the skill does and when to use it, with a genuinely explicit 'Use when...' trigger clause. Its main weakness is that the 'when' clause restates the 'what' rather than broadening trigger coverage, and the action language stays at the generic 'Design ... applications' level.

Suggestions

Add concrete action verbs beyond 'Design' (e.g., 'Build stateful agents with LangGraph, wire up tools with Pydantic schemas, add checkpointed memory, connect vector stores') to lift specificity.

Broaden the trigger clause with natural variations users would say, e.g., 'Use when the user mentions LangChain, LangGraph, AI agents, RAG pipelines, or chatbot/memory implementation'.

Avoid version-pinning '1.x' in the description; name the frameworks so the trigger stays stable across releases.

DimensionReasoningScore

Specificity

The description names the domain ('LangChain 1.x and LangGraph') and capability areas ('agents, memory, and tool integration'), but the only concrete action verb is the generic 'Design', matching the anchor for naming the domain with 1-2 concrete actions rather than the level-above anchor requiring several specific listed actions.

3 / 5

Completeness

Both a clear 'what' ('Design LLM applications using LangChain 1.x and LangGraph...') and an explicit 'Use when...' clause are present, but the 'when' clause largely mirrors the 'what' and offers little additional trigger specificity, matching anchor 4 ('when could be more explicit or specific') rather than the fully concrete, synonym-rich trigger phrasing of anchor 5.

4 / 5

Trigger Term Quality

'building LangChain applications, implementing AI agents, or creating complex LLM workflows' are phrases users would naturally say, but common variations such as 'LangGraph', 'RAG', or 'chatbot' are absent, matching 'good keyword coverage; a few natural terms missing' rather than the comprehensive synonym coverage of level 5.

4 / 5

Distinctiveness Conflict Risk

Naming 'LangChain 1.x and LangGraph' establishes a clear niche with mostly distinct triggers, but 'implementing AI agents' and 'complex LLM workflows' could plausibly fire for non-LangChain agent or LLM-workflow requests, matching 'mostly distinct; minor overlap risk with closely related skills' rather than the minimal-conflict level 5.

4 / 5

Total

15

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

wshobson/agents

Path

plugins/llm-application-dev/skills/langchain-architecture/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.