larksuite/cli · error

create suite staging directory: %w

Error message

create suite staging directory: %w

What it means

Wraps vfs.MkdirTemp failure while creating the temporary staging directory used to install the skills suite archive. Without staging, the suite sync cannot proceed.

Source

Thrown at internal/skillscheck/layout.go:61

	if requested != "" {
		return ParseLayout(string(requested))
	}
	if readable {
		return EffectiveLayout(state), nil
	}
	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

View on GitHub (pinned to 7fd6ef3c07)

Solutions

1. Verify TEMP/TMP permissions and free space
2. Retry after clearing the failing temp-dir state

When it happens

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