larksuite/cli · error

suite archive install failed: %s

Error message

suite archive install failed: %s

What it means

Reports that runner.StageSuite failed to stage the skills suite archive into the staging directory, surfacing the runner's message verbatim during suite sync.

Source

Thrown at internal/skillscheck/layout.go:67

	return LayoutSeparate, nil
}

func syncSuite(runner SkillsRunner, source string, plan SyncPlan, installed []installedSkill) error {
	installedSeparate := installedOfficialNames(installed, plan.CleanupOfficial)
	if len(plan.ToUpdate) == 0 {
		remove := append(installedSeparate, installedNameIfPresent(installed, "lark-suite")...)
		return removeSkills(runner, remove)
	}

	stagingRoot, err := vfs.MkdirTemp("", "lark-cli-suite-")
	if err != nil {
		return fmt.Errorf("create suite staging directory: %w", err)
	}
	defer vfs.RemoveAll(stagingRoot)

	stageResult := runner.StageSuite(source, stagingRoot)
	if stageResult == nil || stageResult.Err != nil {
		return fmt.Errorf("suite archive install failed: %s", resultDetail(stageResult))
	}

	suitePath := filepath.Join(stagingRoot, ".agents", "skills", "lark-suite")
	if err := prepareSuite(suitePath, plan.OfficialSkills, plan.ToUpdate); err != nil {
		return err
	}
	installResult := runner.InstallLocalSuite(suitePath)
	if installResult == nil || installResult.Err != nil {
		return fmt.Errorf("install cropped lark-suite failed: %s", resultDetail(installResult))
	}
	if err := removeSkills(runner, installedSeparate); err != nil {
		return err
	}
	return nil
}

func prepareSuite(suitePath string, official, target []string) error {
	referencesPath := filepath.Join(suitePath, "references")

View on GitHub (pinned to 7fd6ef3c07)

Solutions

1. Check network access to the official skills source
2. Re-run the skills sync; transient fetch or extraction failures usually clear

When it happens

Trigger: Thrown at internal/skillscheck/layout.go:67 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of larksuite/cli@7fd6ef3c07 (2026-09-04). Data as JSON: /api/errors/ae4a6ded2eaa1a75. Report an issue: GitHub.