larksuite/cli · error

skills layout must be separate or suite

Error message

skills layout must be separate or suite

What it means

Guard in ParseLayout: the requested skills layout string is neither empty, "separate", nor "suite". Only these layout values are accepted when configuring skills installation.

Source

Thrown at internal/skillscheck/layout.go:31

	"github.com/larksuite/cli/internal/vfs"
)

type Layout string

const (
	LayoutSeparate         Layout = "separate"
	LayoutSuite            Layout = "suite"
	suiteDescriptionPrefix        = "description: 飞书/Lark 聚合能力入口：管理飞书/Lark 产品能力（"
	suiteDescriptionSuffix        = "等）。"
)

func ParseLayout(value string) (Layout, error) {
	layout := Layout(strings.TrimSpace(value))
	switch layout {
	case "", LayoutSeparate, LayoutSuite:
		return layout, nil
	default:
		return "", fmt.Errorf("skills layout must be separate or suite")
	}
}

func EffectiveLayout(state *SkillsState) Layout {
	if state != nil && state.Layout == LayoutSuite {
		return LayoutSuite
	}
	return LayoutSeparate
}

func ResolveLayout(requested Layout, state *SkillsState, readable bool) (Layout, error) {
	if requested != "" {
		return ParseLayout(string(requested))
	}
	if readable {
		return EffectiveLayout(state), nil
	}
	return LayoutSeparate, nil

View on GitHub (pinned to 7fd6ef3c07)

Solutions

1. Use `separate` or `suite`, or omit the value to get the default

When it happens

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