gcube-ai-toolkit

Shared AI-assisted development tooling for the gCube team, gCube/D4Science-specific only: skills, agents, and workflows for Claude Code and Kilo Code targeting gCube SmartGears 4, Java 17, and D4Science development.

This repo bundles three macro plugin packages: gcube-developer-tools, d4science-ecosystem-tools, and sg3-sg4-assistant. For general-purpose AI-coding skills and agents (not tied to gCube/D4Science), see Relationship with sibling repos.

Table of contents

• Overview
• Relationship with sibling repos
• Installation & Marketplace Integration
• Documentation
• Changelog
• Authors
• How to Cite
• License
• About gCube
• Funding
• Acknowledgements

Overview

Official gCube Repository: Hosted on D4Science Gitea at https://code-repo.d4science.org/gCubeSystem/gcube-ai-toolkit. Serves as the central AI development toolkit and native plugin marketplace for the gCube ecosystem.

Why this exists

This repository exists to distribute, maintain, and share AI-assisted development tools for the gCube development team across Claude Code and Kilo Code, for work that's genuinely gCube/D4Science-specific — SmartGears 4 migration, Java 17 upgrades, D4Science Redmine, gCube CI/CD conventions, and similar.

Repository Structure & Documentation Map

Path	Description
CONTEXT.md	Living architectural context, glossary, and design decisions.
docs/00-INDEX.md	Documentation index and navigation guide.
docs/01-concepts.md	Skills/agents/commands/MCP concepts, generic vs. tool-specific (duplicated from agentic-coding-kit, kept in sync manually — see that doc's own note).
docs/02-authoring-and-maintenance.md	Skill authoring standards, creating a plugin/marketplace (duplicated from agentic-coding-kit).
docs/03-compatibility-and-distribution.md	Install/distribution mechanics for both tools (duplicated from agentic-coding-kit).
docs/04-gcube-operational-workflows.md	gCube-specific skill inventory and task-delegation workflows (this repo's own, not shared).
docs/05-architecture-and-context.md	System architecture, historical/legacy reference notes (this repo's own).

Plugin Packages & Included Skills/Agents Catalog

Plugin Package	Target Domain & Purpose	Included Skills	Included Agents	Path
gcube-developer-tools	Standard gCube Developer Toolkit (Recommended for all developers to standardize project quality and metadata)	gcube-readme-updater, gcube-changelog-updater, gcube-legal-files-updater, gcube-citation-updater, gcube-git-contributors-analyzer	gcube-doc-generator	plugins/gcube-developer-tools/
d4science-ecosystem-tools	Optional & Infrastructure Tools (Helpful tools for specific ecosystem workflows)	d4science-redmine-helper, gcube-osgi-library-wrapper, toolkit-release-manager (internal maintenance tool)	—	plugins/d4science-ecosystem-tools/
sg3-sg4-assistant	SG3 → SG4 Migration Suite (Dedicated tools for SmartGears 4 / Java 17 / Jakarta EE migration)	gcube-sg4-project-updater, gcube-sg-auth, gcube-sg4-descriptors, gcube-sg4-authorized-tasks, gcube-is-analyzer, gcube-sg4-test-migration, gcube-sg4-ci-docker, gcube-migration-validator	sg3-sg4-migrator, gcube-sg-migration-assistant	plugins/sg3-sg4-assistant/

Conventions for this project

• Every doc is written to be read cold — no "as we discussed" references. If a decision was made in conversation, it's recorded in CONTEXT.md with its reasoning.
• Skills, agents, and workflows are bundled here verbatim inside plugins/<plugin-name>/.
• For cross-platform Markdown formatting, .gitignore generation, etc., see agentic-coding-kit.

Relationship with sibling repos

This repo is gCube/D4Science-specific only. For general-purpose AI-coding tooling (not tied to gCube), see:

• agentic-coding-kit — generic skills and agents for Claude Code / Kilo Code: cross-platform dev utilities (common-tools: gitignore, markdown-formatter, macroplan-authoring, merge-resolver), Kilo/Claude tooling (agent-tooling-meta: kilo-plugin-manager, kilo-scope-manager, kilo-claude-sync, roocode-migrator, skill-writer, mode-writer, kilo-customizer, framework-skillset-generator), and a curated set of third-party skills.
• ai-architect-executor — the generic, protocol-agnostic Architect/Executor delegation pattern: task specs, verification workflow, worktree isolation.
• kilo-mcp — the concrete Kilo-specific binding of that pattern: MCP server plus Kilo-specific skills and real tool names.

If you're working on something unrelated to gCube/D4Science and found this repo looking for generic AI-tooling skills, you probably want agentic-coding-kit instead.

Installation & Marketplace Integration

This repository is a native Claude Code / Kilo Code plugin marketplace offering three plugin packages (gcube-developer-tools, d4science-ecosystem-tools, sg3-sg4-assistant) plus their standalone skills.

Claude Code

claude plugin marketplace add https://code-repo.d4science.org/gCubeSystem/gcube-ai-toolkit.git

/plugin install gcube-developer-tools
/plugin install d4science-ecosystem-tools
/plugin install sg3-sg4-assistant

Add --scope project to scope the install to the current workspace instead of globally. /plugin list, /plugin search <query>, /plugin update, /plugin uninstall <name> work as usual — see docs/03-compatibility-and-distribution.md for the full command reference (shared doc, not gCube-specific).

Kilo Code

Via kilo-plugin-manager (from agentic-coding-kit — see its own install instructions), then:

python3 ~/.kilo/skills/kilo-plugin-manager/scripts/plugin_manager.py add https://code-repo.d4science.org/gCubeSystem/gcube-ai-toolkit.git --name gcube
python3 ~/.kilo/skills/kilo-plugin-manager/scripts/plugin_manager.py install gcube-developer-tools@gcube

Or Kilo's native Skill URLs (skills only, no extra tooling):

{
  "skills": {
    "urls": [
      "https://code-repo.d4science.org/gCubeSystem/gcube-ai-toolkit/raw/branch/main/plugins/gcube-developer-tools/skills/",
      "https://code-repo.d4science.org/gCubeSystem/gcube-ai-toolkit/raw/branch/main/plugins/d4science-ecosystem-tools/skills/",
      "https://code-repo.d4science.org/gCubeSystem/gcube-ai-toolkit/raw/branch/main/plugins/sg3-sg4-assistant/skills/"
    ]
  }
}

For in-depth UI details, see docs/03-compatibility-and-distribution.md.

Documentation

• docs/00-INDEX.md: Overview and navigation.
• docs/01-concepts.md, 02-authoring-and-maintenance.md, 03-compatibility-and-distribution.md: shared with agentic-coding-kit, not gCube-specific.
• docs/04-gcube-operational-workflows.md: gCube-specific skill inventory and workflows.
• docs/05-architecture-and-context.md: system architecture and legacy attic notes.

Changelog

See CHANGELOG.md.

Authors

• Alfredo Oliviero as Researcher, Architect, Developer (ORCID)
  • Istituto di Scienza e Tecnologie dell'Informazione 'A. Faedo', Consiglio Nazionale delle Ricerche, Pisa, Italy
  • D4Science Infrastructure, Pisa, Italy

How to Cite

If you use this software, please cite it using the metadata in CITATION.cff.

License

This project is licensed under the terms specified in the LICENSE.md file.

About gCube

This software is part of the gCube Framework: an open-source software toolkit used for building and operating Hybrid Data Infrastructures enabling the dynamic deployment of Virtual Research Environments by favouring the realisation of reuse oriented policies. The gCube Framework supports the development and operation of the D4Science Infrastructure.

Funding

See FUNDING.md.

Acknowledgements

• gCube & D4Science Development Teams