larksuite/cli · error

install cropped lark-suite failed: %s

Error message

install cropped lark-suite failed: %s

What it means

After cropping the staged suite, the InstallLocalSuite call failed to install it into the agent host; %s is the runner's result detail (install target unwritable, host skill directory in a bad state).

Source

Thrown at internal/skillscheck/layout.go:76

	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")
	archived, err := listDirectSubdirs(referencesPath)
	if err != nil {
		return fmt.Errorf("inspect suite archive: %w", err)
	}
	if err := assertSameSkillNames(archived, official, "suite archive"); err != nil {
		return err
	}

	targetSet := toSet(target)

View on GitHub (pinned to 7fd6ef3c07)

Solutions

1. Check the agent skills directory permissions
2. Retry the skills sync after fixing the host-side install target

When it happens

Trigger: Thrown at internal/skillscheck/layout.go:76 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/7c828f790431a3f2. Report an issue: GitHub.