Tencent/WeKnora · error

skill not found: %s

Error message

skill not found: %s

What it means

Lookup guard in TenantSkillSource.row: the requested skill name is not in the tenant's by-name skill map, meaning no tenant skill entity with that name exists (or the source was not refreshed since it was created/deleted). All tenant-sourced operations funnel through row(), so this error backs every "skill not found" for tenant skills.

Source

Thrown at internal/agent/skills/tenant_source.go:261

	if err != nil {
		return "", err
	}
	clean, err := safeSkillRelPath(relativePath)
	if err != nil {
		return "", err
	}
	basePath, err := sandbox.SkillDirFor(row.Name)
	if err != nil {
		return "", err
	}
	return path.Join(basePath, clean), nil
}

func (s *TenantSkillSource) row(name string) (*types.TenantSkillEntity, error) {
	if row, ok := s.byName[name]; ok {
		return row, nil
	}
	return nil, fmt.Errorf("skill not found: %s", name)
}

// safeSkillRelPath normalises a caller-supplied relative path and refuses
// anything that leaves the skill directory.
func safeSkillRelPath(relativePath string) (string, error) {
	trimmed := strings.TrimSpace(relativePath)
	if trimmed == "" {
		return "", fmt.Errorf("skill file path is required")
	}
	if path.IsAbs(trimmed) {
		return "", fmt.Errorf("invalid skill file path: %s", relativePath)
	}
	clean := path.Clean(trimmed)
	if clean == "." || clean == ".." || strings.HasPrefix(clean, "../") {
		return "", fmt.Errorf("invalid skill file path: %s", relativePath)
	}
	return clean, nil
}

View on GitHub (pinned to 988cbb0330)

Solutions

1. Verify the skill name against the tenant's installed skills list
2. Refresh/reload the tenant skill source if the skill was recently added
3. Install the skill for the tenant before referencing it

When it happens

Trigger: Thrown at internal/agent/skills/tenant_source.go:261 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Tencent/WeKnora@988cbb0330 (2026-09-02). Data as JSON: /api/errors/0e6ee4ad7baedd38. Report an issue: GitHub.