conductor-oss/conductor · error · IllegalArgumentException

Skill package is required

Error message

Skill package is required

What it means

Error "Skill package is required" thrown in conductor-oss/conductor.

Source

Thrown at agentspan/src/main/java/org/conductoross/conductor/ai/agentspan/runtime/service/SkillRegistryService.java:142

    /** Whether a host supplied skill storage. */
    public boolean isSkillStorageAvailable() {
        return packageStore != null && metadataDao != null;
    }

    private void requireSkillStorage() {
        if (!isSkillStorageAvailable()) {
            throw new UnsupportedOperationException(
                    "Skills are unavailable: no SkillPackageStore/SkillMetadataDAO is configured for"
                            + " this backend. Agents run without skills; supply both beans to enable"
                            + " skill registration and lookup.");
        }
    }

    public synchronized SkillDetail register(String manifestJson, MultipartFile packageFile) {
        requireSkillStorage();
        if (packageFile == null || packageFile.isEmpty()) {
            throw new IllegalArgumentException("Skill package is required");
        }

        Map<String, Object> manifest = parseManifest(manifestJson);
        byte[] bytes = readPackage(packageFile);
        String checksum = sha256Hex(bytes);

        ParsedSkillPackage parsed = parseSkillPackage(bytes, manifest);
        String name = parsed.name();
        Map<String, Object> rawConfig = parsed.rawConfig();
        String manifestName = stringValue(manifest.get("name"));
        if (manifestName != null && !manifestName.isBlank() && !manifestName.equals(name)) {
            throw new IllegalArgumentException(
                    "Skill manifest name '"
                            + manifestName
                            + "' does not match package SKILL.md name '"
                            + name
                            + "'");
        }

View on GitHub (pinned to cf7c3e4a8a)

Solutions

1. Provide the skill package bytes in the registration request; an empty or null package is rejected.

When it happens

Trigger: Thrown at agentspan/src/main/java/org/conductoross/conductor/ai/agentspan/runtime/service/SkillRegistryService.java:142 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of conductor-oss/conductor@cf7c3e4a8a (2026-08-14). Data as JSON: /api/errors/ce22f4a463699248. Report an issue: GitHub.