CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

langchain-architecture

Master the LangChain framework for building sophisticated LLM applications with agents, chains, memory, and tool integration.

Quality

56%

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 ./skills/langchain-architecture/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

46%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 body delivers substantial, mostly executable LangChain code across agents, chains, memory, callbacks, and testing, but pads it with concept catalogs that restate library documentation Claude already knows. Its biggest structural failure is progressive disclosure: it inlines deep reference material while pointing to bundle files that do not exist, under an inconsistent path scheme, and it teaches a deprecated API without flagging it.

Suggestions

Actually create the advertised bundle files (references/agents.md, references/memory.md, assets/agent-template.py, etc.) and move the inlined catalogs, patterns, and checklists into them, or delete the Resources section; also reconcile the Instructions' 'resources/implementation-playbook.md' path with the 'references/' directory it actually lists.

Cut the concept-definition sections that restate LangChain documentation (the Agents/Chains/Memory type catalogs and their one-line definitions) and keep only non-obvious guidance such as the memory-selection heuristics and Common Pitfalls.

Make code snippets self-contained (define or import 'llm' and 'tools' in Patterns 1-3 and the tests) and add a deprecated/old-patterns note that the examples use the legacy pre-0.1 LangChain API, since version-sensitive imports should not appear as current practice.

DimensionReasoningScore

Conciseness

Large sections restate LangChain documentation Claude already knows, such as 'Agents: Autonomous systems that use LLMs to decide which actions to take' and catalog definitions like 'ConversationBufferMemory: Stores all messages', and the Instructions section is generic filler ('Clarify goals, constraints, and required inputs. Apply relevant best practices and validate outcomes.'). Additionally, the code uses the deprecated pre-0.1 LangChain API (initialize_agent, langchain.llms.OpenAI, langchain.document_loaders) with no version or deprecation flagging, matching anchor 2 ('noticeably verbose; several unnecessary explanations or padded sections') rather than 3, where padding would be incidental.

2 / 5

Actionability

The body is dominated by concrete, mostly executable LangChain code covering the common cases (Quick Start agent, RAG pattern, memory selection, callbacks, tests), matching anchor 4 ('mostly executable guidance; concrete code or commands with minor gaps'). It is not a 5 because Pattern 1 and 3 reference an undefined 'llm' variable, Pattern 2 imports unused symbols while calling an unimported 'initialize_agent', and tool bodies are stubs ('# Your database search logic') rather than copy-paste ready.

4 / 5

Workflow Clarity

The Instructions give a rough sequence ('Clarify goals, constraints, and required inputs' -> 'Apply relevant best practices and validate outcomes') but validation is purely abstract with no concrete checkpoints, matching anchor 3 ('steps listed but validation gaps; sequence present but checkpoints missing or implicit'). The Testing Strategies and Production Checklist sections keep it from dropping to 2, and the vague instruction language keeps it below 4.

3 / 5

Progressive Disclosure

The Resources section points to 'references/agents.md', 'references/memory.md', 'assets/agent-template.py' and others, but none of these bundle files exist, and the Instructions reference 'resources/implementation-playbook.md', a path inconsistent even with the Resources listing. Meanwhile roughly 250 lines of API-catalog and pattern content that belongs in those separate files is inlined in SKILL.md, matching anchor 2 ('content that clearly belongs in separate files is inlined') rather than 3, where references would at least be present and functional.

2 / 5

Total

11

/

20

Passed

Description

48%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.

The description clearly names its niche (LangChain) and its sub-domains, but provides no 'Use when...' trigger guidance and only one broad action in imperative rather than third-person voice. It is serviceable but below the quality of the reference good examples, which combine concrete actions with explicit trigger phrases.

Suggestions

Add an explicit trigger clause, e.g. 'Use when building LangChain applications, agents, RAG pipelines, or LLM chains, or when the user mentions LangChain, LLM agents, or conversation memory.'

Rewrite in third-person declarative voice with concrete actions: 'Builds LLM applications with LangChain: implements agents with tool access, composes sequential and RAG chains, configures conversation memory, and integrates external data sources.'

Include natural trigger variations users actually say, such as RAG, retrieval-augmented generation, chatbots, prompt chaining, and vector stores, to improve trigger coverage beyond the bare framework name.

DimensionReasoningScore

Specificity

The description offers one broad action ('building sophisticated LLM applications') and enumerates domain topics ('agents, chains, memory, and tool integration') rather than concrete capabilities, matching the anchor 'names the domain but actions are minimal or generic'. It is also written in imperative voice ('Master the LangChain framework') instead of third person, which the guidelines penalize by reducing specificity by 1 from a base of 3.

2 / 5

Completeness

The 'what' is stated ('building sophisticated LLM applications with agents, chains, memory, and tool integration') but there is no 'Use when...' clause or equivalent trigger guidance, which the guidelines cap at 3. It is not a 2 because the 'what' half is clear and domain-specific, and not a 4 because the 'when' half is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

It includes the natural keyword 'LangChain' plus relevant sub-terms ('LLM applications', 'agents', 'memory', 'tool integration'), but misses common variations users would say such as RAG, retrieval, chatbots, prompts, vector stores, or document loading. This fits anchor 3 ('some relevant keywords but missing common variations or synonyms') better than anchor 4, where only a few natural terms would be missing.

3 / 5

Distinctiveness Conflict Risk

'Master the LangChain framework' names a specific framework, giving it a clear niche with distinct triggers and low wrong-skill risk. It falls short of anchor 5 because the broad phrase 'sophisticated LLM applications with agents, chains, memory' overlaps with closely related skills (LangGraph, LlamaIndex, generic LLM-agent building), matching 'mostly distinct; minor overlap risk with closely related skills'.

4 / 5

Total

12

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 8 missing

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

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.