Skip to content

feat: Add aigne plugin for AIGNE Framework development guide#5

Open
lban2049 wants to merge 7 commits intomainfrom
feature/add-aigne-agent-skill
Open

feat: Add aigne plugin for AIGNE Framework development guide#5
lban2049 wants to merge 7 commits intomainfrom
feature/add-aigne-agent-skill

Conversation

@lban2049
Copy link

Summary

Add a new aigne plugin that provides comprehensive documentation and guidance for building AI agents using the AIGNE Framework CLI.

This plugin was migrated from ~/.claude/skills/aigne-agent-developer to be managed within this repository, following the project's plugin organization structure.

What's Included

New Plugin Structure

plugins/aigne/
├── .claude-plugin/plugin.json
├── README.md
└── skills/aigne-agent-developer/
├── SKILL.md
└── references/
├── agent-types.md
├── agent-definition.md
├── skill-definition.md
├── workflow-patterns.md
└── aigne-yaml-config.md

Key Features

  • Agent Types: AI, Team, Function (.mjs), Image, MCP agents
  • Workflow Patterns: Sequential, parallel, batch processing, reflection
  • Best Practices: Schema requirements, file extensions, common pitfalls
  • Reference Guide: Task-based navigation to detailed documentation

Trigger Phrases

  • "create an agent"
  • "write a skill"
  • "configure aigne.yaml"
  • "help me build an AIGNE project"

Changes

  • Added plugins/aigne/ with complete skill structure
  • Updated marketplace.json to include the new plugin
  • Updated README.md and README-zh.md with plugin description

Stats

  • 11 files changed
  • 1,074 lines added

lban2049 and others added 7 commits January 13, 2026 21:58
Migrate the aigne-agent-developer skill from ~/.claude/skills/ to this
project. The plugin provides comprehensive documentation for building
AI agents using the AIGNE Framework CLI.

New plugin structure:
- plugins/aigne/.claude-plugin/plugin.json
- plugins/aigne/README.md
- plugins/aigne/skills/aigne-agent-developer/SKILL.md
- plugins/aigne/skills/aigne-agent-developer/references/
  - agent-types.md
  - agent-definition.md
  - skill-definition.md
  - workflow-patterns.md
  - aigne-yaml-config.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Key changes:
- Use .mjs extension for Function Agents (not .js)
- Use .env.example template instead of .env.local
- ALL agents must define both input_schema AND output_schema
- Default recommended model: google/gemini-3-pro
- Add Best Practices section (5 guidelines)
- Add Common Pitfalls section (4 anti-patterns)
- CLI parameter syntax clarification

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Streamlined SKILL.md with cleaner structure:
- Simplified Agent Types table with file extensions
- Added Image Agent section (output is file path, not base64)
- Updated model to google/gemini-3-pro-preview
- Condensed Key Rules to 6 essential points
- Removed verbose Best Practices/Common Pitfalls sections
- References link to detailed docs in references/ directory

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
New sections in aigne-agent-developer skill:
- Reflection Mechanism Details: explains that reviewer receives
  output from last skill, with wrong/correct examples for
  mid-workflow reflection using nested Team Agents
- Calling other agents from Function Agent: shows how to use
  options.context.agents and options.context.invoke() to call
  agents programmatically (without importing @anthropic-ai/aigne)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Major simplification:
- Add Reference Guide table linking to detailed docs
- Reduce Critical Rules to 4 essential items
- Consolidate Common Pitfalls section with:
  - Function Agent inter-agent invocation
  - Reflection data flow (nested Team Agent pattern)
  - Batch processing array format (objects not primitives)
- Remove redundant content now covered in references/

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Updated files:
- agent-definition.md: minor fixes
- agent-types.md: cleanup
- skill-definition.md: +30 lines of new content
- workflow-patterns.md: +32 lines of new content

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Updated:
- agent-definition.md
- agent-types.md
- aigne-yaml-config.md (use .mjs extension in examples)
- skill-definition.md
- workflow-patterns.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant