/**
 * Universal skills directory convention.
 *
 * The universal skills directory (`.agents/skills`) is a shared cross-agent
 * convention used by multiple coding agents. Skills placed here are visible to
 * every agent that opts in, rather than being scoped to a single agent's
 * configuration directory.
 *
 * @experimental This API is unstable and may change without notice.
 * @packageDocumentation
 */
/**
 * WorkspaceMutations-relative path of the universal skills directory.
 */
export declare const UNIVERSAL_SKILLS_DIR = ".agents/skills";
/**
 * First path segment of {@link UNIVERSAL_SKILLS_DIR}.
 *
 * Used by detection and lint logic to exclude the universal directory from
 * agent-specific filesystem probes.
 */
export declare const UNIVERSAL_SKILLS_DIR_SEGMENT: string;
/**
 * Strips trailing path separators from a path string.
 */
export declare const stripTrailingSeparators: (p: string) => string;
/**
 * Returns `true` when `dir` is the workspace-relative universal skills
 * directory path. Use for descriptor-level comparisons where paths are
 * relative (e.g., `agent.skills.dir`).
 *
 * @see {@link isUniversalSkillsDir} for absolute resolved-path comparisons
 * (e.g., after `resolveEffectiveSkillsDir`).
 */
export declare const isUniversalSkillsRelativeDir: (dir: string) => boolean;
/**
 * Resolve per-agent artifact presence when some agents share the universal
 * skills directory. If any agent in `universalAgentIds` has the artifact,
 * all agents in that set are treated as having it — because the directory
 * is shared, one symlink/copy satisfies them all.
 *
 * Returns the input unchanged when `universalAgentIds` is empty.
 */
export declare const resolveUniversalDirPresence: <T extends {
    readonly agentId: string;
    readonly exists: boolean;
}>(perAgent: ReadonlyArray<T>, universalAgentIds: ReadonlySet<string>) => ReadonlyArray<T>;
/**
 * Returns `true` when `resolvedDir` points to the universal skills directory
 * (`<workspaceRoot>/.agents/skills`).
 *
 * Both paths are normalized by stripping trailing separators before comparison.
 *
 * Intended for comparing resolved absolute paths from `resolveEffectiveSkillsDir`.
 * For descriptor-level relative paths, use {@link isUniversalSkillsRelativeDir}.
 */
export declare const isUniversalSkillsDir: (resolvedDir: string, workspaceRoot: string) => boolean;
//# sourceMappingURL=universal-skills-dir.d.ts.map