angkira avatar

argentic-framework-development

Expert knowledge for building AI agents with Argentic - a Python microframework for async MQTT-based

提供方 angkira|开源

Argentic Framework - Claude Skill

This is a Claude Skill for the Argentic AI agent framework.

What is this?

A pre-packaged knowledge module that Claude can load to gain expert-level understanding of the Argentic framework. When you load this skill, Claude will know how to:

  • Build single-agent applications
  • Create custom tools with Pydantic validation
  • Implement multi-agent systems with Supervisor
  • Configure LLM providers (Gemini, Ollama, Llama.cpp)
  • Handle MQTT messaging and async patterns
  • Debug common issues

How to Use

For Claude Desktop/Code

  1. Prepare the Skill Package:

    • This directory contains the skill files
    • The ZIP file (argentic-skill.zip) is ready to upload

  2. Upload to Claude:

    • Open Claude settings
    • Navigate to "Features" or "Capabilities" section
    • Click "Add Skill" or "Upload Skill"
    • Select argentic-skill.zip
    • Claude will automatically detect and activate the skill

  3. Use in Projects:

    • Open a project using Argentic
    • Claude will automatically recognize when to use this skill
    • Start asking questions like:
      • "Create a single agent with a weather tool"
      • "Build a multi-agent system with researcher and analyst"
      • "How do I debug tool registration issues?"

Automatic Activation

Claude automatically determines when to use this skill based on:

  • Project dependencies (if argentic is in requirements.txt or pyproject.toml)
  • File content (if importing from argentic package)
  • Explicit requests ("Using Argentic framework, create...")

What's Included

  • SKILL.md - Main skill file with:

    • Framework overview
    • 3 complete patterns (single agent, custom tool, multi-agent)
    • Configuration examples
    • API reference
    • Best practices
    • Troubleshooting guide

  • examples/ - Working code examples:

    • Single agent application
    • Custom tool implementation
    • Multi-agent system

Skill Metadata

  • Name: Argentic Framework Development
  • Description: Expert knowledge for building AI agents with async MQTT messaging
  • Version: 1.0 (for Argentic 0.11.x)
  • Language: Python 3.11+

When Claude Uses This Skill

Claude will apply this skill when you:

  • Ask about Argentic framework
  • Work with files importing argentic
  • Request AI agent implementation
  • Need help with MQTT messaging patterns
  • Debug Argentic applications
  • Configure multi-agent systems

Benefits

✅ Instant Expertise - Claude knows Argentic API without context window overhead
✅ Best Practices - Built-in knowledge of proper patterns
✅ Working Examples - Copy-paste ready code
✅ Troubleshooting - Common issues and solutions
✅ Multi-Pattern Support - Single agent, tools, multi-agent

Maintenance

To update this skill:

  1. Edit SKILL.md with new patterns or API changes
  2. Add new examples to examples/ directory
  3. Re-zip the directory: zip -r argentic-skill.zip argentic-skill/
  4. Re-upload to Claude

Comparison to .cursorrules

Claude Skill:

  • ✅ Claude-specific optimization
  • ✅ Dynamic loading based on context
  • ✅ Doesn't consume project context window
  • ✅ Can include binary files, PDFs
  • ❌ Claude Desktop/Code only

.cursorrules:

  • ✅ Works with Cursor and other AI tools
  • ✅ Version controlled with project
  • ✅ No upload needed
  • ❌ Uses context window
  • ❌ Cursor-specific

Use both for maximum compatibility!

Version History

  • v1.0 (Oct 2025) - Initial release
    • Single agent pattern
    • Custom tool development
    • Multi-agent systems
    • All LLM providers
    • Complete API reference

Support

For Argentic framework issues:

For Claude Skill issues:

  • Check Claude documentation on Skills
  • Verify ZIP structure is correct
  • Ensure SKILL.md has proper YAML front matter
下载 Skill