Skip to content

Add and Consolidate Claude Code skills for all Agent Templatess#96

Merged
bbqiu merged 14 commits intodatabricks:mainfrom
dhruv0811:split-agents-md-into-skills
Feb 2, 2026
Merged

Add and Consolidate Claude Code skills for all Agent Templatess#96
bbqiu merged 14 commits intodatabricks:mainfrom
dhruv0811:split-agents-md-into-skills

Conversation

@dhruv0811
Copy link
Contributor

@dhruv0811 dhruv0811 commented Jan 28, 2026 •
edited
Loading

Summary

Consolidates all agent skills into a centralized source of truth with a sync script, enabling easier maintenance across all templates. Added and synced skills to agent-langgraph, agent-langgraph-short-term-memory, agent-langgraph-long-term-memory, agent-openai-agents-sdk, agent-non-conversational.

Skill File Architecture

.claude/
├── sync-skills.py              # Syncs skills to all templates
└── skills/                     # Source of truth
    ├── quickstart/
    ├── run-locally/
    ├── discover-tools/
    ├── deploy/                 # Consolidated (was deploy + deploy-memory)
    ├── add-tools-langgraph/    # LangGraph SDK
    ├── add-tools-openai/       # OpenAI SDK
    ├── modify-langgraph-agent/ # LangGraph SDK
    ├── modify-openai-agent/    # OpenAI SDK
    ├── lakebase-setup/         # Memory setup
    └── agent-memory/           # Memory patterns

Changes

Centralized Skills with Sync Script

  • .claude/skills/ contains source of truth for all skills
  • .claude/sync-skills.py copies skills to templates with:
    • {{BUNDLE_NAME}} placeholder substitution
    • SDK-specific skill mapping (langgraph vs openai)
    • Memory skills for all LangGraph templates

Usage

To sync skills after making changes to source:

python .claude/sync-skills.py

Testing Performed

  • Verified sync script works from any directory
  • Verified {{BUNDLE_NAME}} substitution in all templates
  • Verified skill content covers all README.md documentation

@dhruv0811 dhruv0811 changed the title Add Claude Code Skills to Memory Templates Add Claude Code Skills to Agent Langgraph Templates Jan 28, 2026
jennsun
jennsun reviewed Jan 28, 2026
View reviewed changes
agent-langgraph-long-term-memory/.claude/skills/agent-memory/SKILL.md Outdated
@@ -0,0 +1,220 @@
---
name: agent-memory
description: "Understand and modify agent memory patterns. Use when: (1) User asks about 'memory', 'state', 'user preferences', (2) Working with user_id or memory tools, (3) Debugging memory issues, (4) Adding short-term memory capabilities."
Copy link
Contributor

@jennsun jennsun Jan 28, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
description: "Understand and modify agent memory patterns. Use when: (1) User asks about 'memory', 'state', 'user preferences', (2) Working with user_id or memory tools, (3) Debugging memory issues, (4) Adding short-term memory capabilities."
description: "Understand and modify agent memory patterns. Use when: (1) User asks about 'memory', 'state', 'user preferences', (2) Working with user_id or memory tools, (3) Debugging memory issues, (4) Adding short-term memory capabilities (5) Adding long-term memory capabilities"

@dhruv0811 dhruv0811 force-pushed the split-agents-md-into-skills branch from a65c68d to 5410647 Compare January 28, 2026 23:44
dhruv0811 and others added 8 commits January 29, 2026 13:57
@dhruv0811
Added Skills to Agents Langgraph Template
2d48ec0
@dhruv0811
Agent langgraph modify agent skill update
6718049
@dhruv0811
Added lakebase template agent skills
c681775
@dhruv0811 @claude
Add memory skills to base agent-langgraph template
ef4c96a 
Added lakebase-setup and agent-memory skills for users who want to add
memory capabilities to the base template. Skills include references to
pre-configured memory templates for easier discovery.

Co-Authored-By: Claude (databricks-claude-opus-4-5) <noreply@anthropic.com>
@dhruv0811 @claude
Update skills to use .env instead of .env.local
266ea1b 
Aligns with PR databricks#99 changes that standardized on .env file naming.

Co-Authored-By: Claude (databricks-claude-opus-4-5) <noreply@anthropic.com>
@dhruv0811 @claude
Skill updates for lakebase memory
43eb726 
Co-Authored-By: Claude (databricks-claude-opus-4-5) <noreply@anthropic.com>
@dhruv0811
Fixed .env.local references
e49d924
@dhruv0811
Added service principal info
21d3289
jennsun
jennsun reviewed Jan 29, 2026
View reviewed changes
agent-langgraph-long-term-memory/.claude/skills/agent-memory/SKILL.md
```

## Next Steps

Copy link
Contributor

@jennsun jennsun Jan 29, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

let's add a new skill? section under agent-memory for permission granting

@bbqiu bbqiu self-requested a review January 30, 2026 00:29
@dhruv0811 @claude
Consolidate skills with sync script
aa3519e 
- Add .claude/skills/ as source of truth for all skills
- Add .claude/sync-skills.py to copy skills to templates
- Consolidate deploy and deploy-memory into single deploy skill
- Make discover-tools SDK-agnostic (no code examples)
- Update AGENTS.md with interactive first actions across all templates
- Fix .gitignore files (remove databricks.yml, fix .claude tracking)
- Add databricks bundle validate step to deploy skill

Skills are now maintained in one place and synced to templates,
enabling `databricks workspace export-dir` to work correctly.

Co-Authored-By: Claude (databricks-claude-opus-4-5) <noreply@anthropic.com>
@dhruv0811 dhruv0811 force-pushed the split-agents-md-into-skills branch from 9ae1158 to aa3519e Compare January 30, 2026 20:01
@dhruv0811 dhruv0811 changed the title Add Claude Code Skills to Agent Langgraph Templates Consolidate Claude Code skills with sync script Jan 30, 2026
@dhruv0811 dhruv0811 changed the title Consolidate Claude Code skills with sync script Consolidate Claude Code skills for all Agent Templatess Jan 30, 2026
@dhruv0811 dhruv0811 changed the title Consolidate Claude Code skills for all Agent Templatess Add and Consolidate Claude Code skills for all Agent Templatess Jan 30, 2026
@dhruv0811 dhruv0811 requested a review from jennsun January 30, 2026 21:09
jennsun
jennsun reviewed Jan 30, 2026
View reviewed changes
jennsun
jennsun reviewed Jan 30, 2026
View reviewed changes
jennsun
jennsun reviewed Jan 30, 2026
View reviewed changes
jennsun
jennsun reviewed Jan 30, 2026
View reviewed changes
bbqiu
bbqiu reviewed Jan 30, 2026
View reviewed changes
Copy link
Contributor

@bbqiu bbqiu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

overall looks great! left a few comments to address

jennsun
jennsun reviewed Jan 30, 2026
View reviewed changes
dhruv0811 and others added 5 commits February 2, 2026 09:42
@dhruv0811 @jennsun
Update .claude/skills/lakebase-setup/SKILL.md
1e77bf4 
Co-authored-by: Jenny <jennysunnjm@gmail.com>
@dhruv0811 @claude
Add .gitattributes to hide synced skills in diffs
867ac80 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@dhruv0811 @claude
Refactor agent-memory skill: principles over static code
c1bf240 
- Rename agent-memory -> agent-langgraph-memory in parent .claude/
- Add "Key Principles" section with 5 focused patterns
- Add "Production Reference" section linking to utils_memory.py
- Remove full tool implementations (~150 lines of duplicated code)
- Reduce skill from 515 to 370 lines (~28% reduction)
- Update sync script to copy agent-langgraph-memory -> agent-memory

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@dhruv0811 @claude
Add memory_tools.py example for standalone template use
cd36cf2 
- Add examples/memory_tools.py with full implementation
- Include all helper functions (get_user_id, resolve_lakebase_instance_name, etc.)
- Update SKILL.md with "Complete Example" section and copy command
- Synced to all LangGraph templates

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@dhruv0811 @claude
Fix .gitignore to track renamed agent-langgraph-memory skill
73b0d11 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@dhruv0811 dhruv0811 requested review from bbqiu and jennsun February 2, 2026 19:17
bbqiu
bbqiu approved these changes Feb 2, 2026
View reviewed changes
Copy link
Contributor

@bbqiu bbqiu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm! this is a huge win and will hopefully make our template more accessible to developers

@bbqiu bbqiu merged commit 9f7ab16 into databricks:main Feb 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@bbqiu bbqiu bbqiu approved these changes

@jennsun jennsun Awaiting requested review from jennsun

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@dhruv0811 @jennsun @bbqiu