Agentic Skills

By default, Graph Studio uses skills-only mode — the AI assistant sees a single compact skills catalog tool (general_skills_catalog) and discovers specific tools on demand. All registered tools are available through the catalog but are not listed individually until the AI requests them. This provides 80–90% fewer tokens per request compared to exposing all tool definitions upfront.

How the AI Uses Skills

1. List skills — The AI sees skill names and one-line summaries (~300 tokens)
2. Resolve a skill — Expands a skill to see its tools, sub-skills, and shared context (~500 tokens)
3. Resolve a tool — Gets the full tool definition with parameter schema (~800 tokens)
4. Resolve a type — Gets the full schema for a polymorphic subtype (when a tool's type field has an enum of subtypes)
5. Call the tool — Invokes the tool with the correct parameters

The AI only loads what it needs, when it needs it. You describe what you want in natural language and the assistant discovers the appropriate skill(s) and tool(s) automatically.

Sub-Skills

Skills can contain sub-skills — child skills that group tools into finer categories within a parent skill. When the AI resolves a parent skill, it sees both direct tool references and a list of sub-skills it can drill into further.

Sub-skills support hierarchical organization:

• A parent skill can have both direct tools and sub-skill references
• When resolved, the parent shows sub-skill names with [N tools] counts
• The AI resolves a sub-skill using the same resolve_skill action with the sub-skill's ID
• Sub-skills carry their own shared context and tool references

A skill marked as sub-skill only (isSubSkillOnly = true) is hidden from the top-level catalog listing and only appears when its parent skill is resolved. This keeps the top-level catalog compact while allowing deep hierarchy.

Example: A parent skill "Data Management" could have sub-skills for "File Staging", "Migration", and "Versioning". The AI sees the parent in the catalog, resolves it to discover the sub-skills, then resolves the specific sub-skill it needs.

Default Skills

The following skills are included out of the box. Administrators can add, edit, and remove skills at any time through the admin panel — these are the defaults, not a fixed set.

Skill ID	Name	Description	Tools
save	Save & Ontology Management	Create, update, and delete ontologies and graph data via the transactional save service. Browse and query ontology registries	9
ontology_design	Ontology Design Guidance	Graph Studio ontology compliance best practices. Use when designing, reviewing, or generating OWL ontologies for Graph Studio Before designing a target ontology, always resolve the discovery skill to analyze source data and inform modeling decisions.	2
discovery	Data Discovery	Explore registered ontologies, classes, and properties. Get live graphmart analytics or pre-computed profiling metrics. Use when asked to analyze, explore, profile, summarize, inspect, or understand data.	3 sub-skills
discovery_schema	Ontology Schema Discovery (sub-skill)	Explore registered ontologies, classes, datatype properties, and object properties from the Ontology registry — no graphmart needed.	4
discovery_analytics	Live Graphmart Analytics (sub-skill)	Get live class/property instance counts from AnzoGraph and discover graphmart layers, ontologies, and query endpoint — fast, no profiling needed.	2
discovery_profiling	Profiling Metrics Discovery (sub-skill)	Retrieve pre-computed profiling metrics (sample values, distributions, null rates, cardinality) for graphmart data, or trigger profiling.	4
graphmart	Graphmart Management	Create, activate, reload, and manage graphmarts. Covers all source types: files (CSV, JSON, RDF), RDBMS databases (MySQL, PostgreSQL, SQL Server, Oracle, DB2, Snowflake, Databricks), and journal datasets. Resolve the appropriate sub-skill for source-specific guidance.	13 + 3 sub-skills
graphmart_file	Graphmart from File Sources (sub-skill)	File-specific SourceLayer/FileSource guidance and run configs.	3
graphmart_rdbms	Graphmart from RDBMS Sources (sub-skill)	RDBMS datasource creation and DbSource layer guidance.	6
graphmart_journal	Graphmart from Journal Dataset (sub-skill)	Journal dataset Layer + LoadDatasetStep guidance.	2
datasets	Dataset & Edition Management	List, create, modify, delete, and inspect datasets (FLDS), editions, and components. Use when the user asks to 'list datasets', 'create a dataset', 'delete a dataset', 'create an edition', 'manage editions', 'manage components', or otherwise work with datasets and their contents.	12
layer	Layer & Step Management	Create, modify, delete layers, steps, and views.	26
query	Query & Data Operations	Run SPARQL queries/updates, use the CLI for complex operations, and import data.	2
infrastructure	Infrastructure & Connections	Manage file connections, datasources, Lakehouse (AnzoGraph) connections, Elasticsearch configs, launch configs, and SSO providers.	29
unstructured	Unstructured Data Pipelines	Manage unstructured data ingestion pipelines, crawlers, and annotators. Use when the user asks to 'create a pipeline', 'run a pipeline', 'list pipelines', 'manage crawlers', 'manage annotators', 'ingest unstructured data', or otherwise work with unstructured data processing.	21
file_staging	File Staging Area Management	Browse, list, upload, delete, and rename files and folders in file connection staging areas. Use when an agent needs to inspect available files, add source files for GDI load steps, or manage files in a staging area.	9
migration	Migration & Versioning	Create versions, build migration packages, export/import between environments, and manage the full promotion lifecycle.	14
user_management	User & Group Management	Create, read, update, delete, and search users and groups/roles. Use when the user asks to 'create a user', 'add a user', 'delete a user', 'remove a user', 'list users', 'search users', 'find users', 'change password', 'reset password', 'create a group', 'add a group', 'delete a group', 'remove a group', 'create a role', 'add a role', 'assign a role', 'manage users', or otherwise manage users, groups, and roles.	7
skills_management	Skills Catalog Management	Create, modify, delete, and inspect skills and their tool references in the Agentic Skills Catalog. Use when the user asks to 'create a skill', 'add a skill', 'modify a skill', 'delete a skill', 'list skills', or otherwise manage skills and their tool references. This is the preferred way to manage skills — do not create local SKILL.md files unless explicitly requested.	15
acls	Access Control Management	Retrieve, modify, replace, and reset access control lists (ACLs) on graphs and resources. Use when the user asks to 'set permissions', 'manage ACLs', 'grant access', 'revoke access', 'check permissions', 'reset ACLs', or otherwise work with access control.	4

Tools not assigned to a skill are automatically grouped by their name prefix into dynamic skill buckets:

Prefix	Dynamic Skill ID	Name
service_*	services_other	Other Semantic Services
rest_*	rest_other	Other REST APIs
general_*	general_other	Other Generic Tools
(anything else)	uncategorized	Uncategorized Tools

Dynamic skills only appear when matching tools are registered. The set of available tools depends on which services are registered at runtime. In SKILLS_CURATED mode, dynamic auto-grouping is disabled — only explicitly-defined skills appear.

Example Tools

The default skills include tools like these (additional tools from semantic services and other sources are automatically discovered at runtime):

Skill ID	Tool Names
Save & Ontology	rest_uploadModel, rest_downloadModel, rest_retrieveModels, rest_deleteModel, service_UniformSaveService-save, general_graphStudioClient, general_sparqlClient (x3, with aliased descriptions)
Ontology Design	rest_uploadModel, general_sparqlClient
Discovery (Schema)	general_discoverOntologies, general_discoverClasses, general_discoverDataProperties, general_discoverObjectProperties
Discovery (Analytics)	general_discoverGraphmartOntologies, general_getGraphmartAnalytics
Discovery (Profiling)	general_discoverClassMetrics, general_discoverPropertyMetrics, service_DataProfilerService-generateMetrics, service_DataProfilerService-extractOntology
Graphmart	rest_listGraphmarts, rest_createGraphmart, rest_modifyGraphmart, rest_retrieveGraphmart, rest_deleteGraphmart, rest_activateGraphmart, rest_deactivateGraphmart, rest_retrieveGraphmartStatus, rest_retrieveGraphmartLayers, rest_refreshGraphmart, rest_reloadGraphmart, rest_listStaticAzgs, rest_retrieveServerVersion
Graphmart (File)	rest_retrieveGraphmartRunConfigs, rest_createGraphmartRunConfig, rest_deleteGraphmartRunConfig
Graphmart (RDBMS)	rest_createDatasource, rest_listDatasources, rest_retrieveDatasource, rest_modifyDatasource, rest_deleteDatasource, rest_createGraphmartLayer
Graphmart (Journal)	rest_listDatasets, general_sparqlClient
Datasets	rest_listDatasets, rest_retrieveDataset, rest_createEmptyFLDS, rest_modifyDataset, rest_deleteDataset, rest_createDatasetEdition, rest_retrieveEdition, rest_modifyEdition, rest_deleteEdition, rest_retrieveComponent, rest_modifyComponent, rest_deleteComponent
Layer & Step	rest_listDatasets, rest_retrieveGraphmartLayers, rest_createGraphmartLayer, rest_retrieveLayer, rest_retrieveLayerStatus, rest_modifyLayer, rest_moveGraphmartLayer, rest_deleteLayer, rest_deleteGraphmartLayer, rest_retrieveLayerSteps, rest_createLayerStep, rest_retrieveStep, rest_retrieveStepStatus, rest_modifyStep, rest_deleteLayerStep, rest_createLayerView, rest_deleteLayerView, rest_replaceLayerMapping, rest_retrieveLayerMapping, rest_deleteLayerMapping, rest_deleteStep, rest_retrieveLayerViews, rest_retrieveView, rest_modifyView, rest_deleteView, rest_refreshLayer
Query	general_sparqlClient, general_graphStudioClient
Infrastructure	rest_createFileConnection, rest_listFileConnections, rest_retrieveFileConnection, rest_modifyFileConnection, rest_deleteFileConnection, rest_listDatasources, rest_retrieveDatasource, rest_listStaticAzgs, rest_retrieveStaticAzg, rest_createStaticAzg, rest_modifyStaticAzg, rest_deleteStaticAzg, rest_reconnectToStaticAzg, rest_listElasticsearchConfigs, rest_retrieveElasticsearchConfig, rest_createElasticsearchConfig, rest_modifyElasticsearchConfig, rest_deleteElasticsearchConfig, rest_testElasticsearchConnection, rest_createDatasource, rest_modifyDatasource, rest_deleteDatasource, rest_listAzgLaunchConfigs, rest_listElasticLaunchConfigs, rest_listSSOProviders, rest_retrieveSSOProvider, rest_createSSOProvider, rest_modifySSOProvider, rest_deleteSSOProvider
Unstructured	rest_listUnstructuredPipelines, rest_retrieveUnstructuredPipeline, rest_createUnstructuredPipeline, rest_modifyUnstructuredPipeline, rest_deleteUnstructuredPipeline, rest_runPipeline, rest_cancelPipeline, rest_retrievePipelineStatus, rest_testConnectivity, rest_createPipelineCrawler, rest_deletePipelineCrawler, rest_createPipelineAnnotator, rest_deletePipelineAnnotator, rest_listCrawlers, rest_retrieveCrawler, rest_modifyCrawler, rest_deleteCrawler, rest_listAnnotators, rest_retrieveAnnotator, rest_modifyAnnotator, rest_deleteAnnotator
File Staging	rest_listFileConnections, rest_retrieveFileConnection, rest_listFiles, rest_uploadFile, rest_copyFile, rest_deleteFileEntry, service_VFSUtilityService-createFolder, service_VFSUtilityService-renameFile, rest_uploadModel
Migration	rest_listMigrationPackages, rest_createMigrationPackage, rest_retrieveMigrationPackage, rest_exportMigrationPackage, service_MigrationService-importMigrationPackage, service_MigrationService-addArtifactsToMigrationPackage, service_MigrationService-removeArtifactsFromMigrationPackage, service_MigrationService-refreshMigrationPackage, rest_createVersion, service_VersioningService-revertVersion, service_VersioningService-getVersionsForGraph, service_ExportService-getAllRelatedGraphs, general_sparqlClient, service_UniformSaveService-save
User Management	service_PrincipalSearchService-findPrincipals, service_PrincipalSearchService-getPrincipalDetails, service_UserManagementService-addModifyUsersAndSync, service_UserManagementService-removeUsers, service_UserManagementService-changeUserPassword, service_UniformSaveService-save, service_UserManagementService-invalidateUserCache
Skills Management	rest_listSkills, rest_retrieveSkill, rest_createSkill, rest_modifySkill, rest_deleteSkill, rest_listSkillToolReferences, rest_retrieveSkillToolReference, rest_createSkillToolReference, rest_modifySkillToolReference, rest_deleteSkillToolReference, rest_listSkillSubSkillReferences, rest_retrieveSkillSubSkillReference, rest_createSkillSubSkillReference, rest_modifySkillSubSkillReference, rest_deleteSkillSubSkillReference
ACLs	rest_retrieveAcls, rest_modifyAcls, rest_replaceAcls, rest_resetAcls