Formatter
Defined in: formatters/src/types.ts:93
Common interface for all formatters.
Extended by
Properties
defaultConvention
readonlydefaultConvention:string
Defined in: formatters/src/types.ts:101
Default convention for this formatter
description
readonlydescription:string
Defined in: formatters/src/types.ts:99
Human-readable description
name
readonlyname:string
Defined in: formatters/src/types.ts:95
Unique formatter identifier
outputPath
readonlyoutputPath:string
Defined in: formatters/src/types.ts:97
Default output file path
Methods
format()
format(
ast,options?):FormatterOutput
Defined in: formatters/src/types.ts:103
Transform AST to target format
Parameters
ast
options?
Returns
formatCanonical()?
optionalformatCanonical(ast,options?):FormatterOutput
Defined in: formatters/src/types.ts:111
Optional canonical entry point.
Implementations that do not provide this method are legacy formatters.
The formatter adapter creates a detached compatibility projection before
invoking their format method.
Parameters
ast
options?
Returns
getDotDir()?
optionalgetDotDir():string|null
Defined in: formatters/src/types.ts:120
Dot directory of the target (e.g., ‘.claude’), used for the {{prs.dotDir}}
path token. Null or not implemented leaves the token as written.
Returns
string | null
getSkillBasePath()
getSkillBasePath():
string|null
Defined in: formatters/src/types.ts:113
Base path for skills (e.g., ‘.claude/skills’), or null if no skill support
Returns
string | null
getSkillFileName()
getSkillFileName():
string|null
Defined in: formatters/src/types.ts:115
Skill file name (e.g., ‘SKILL.md’ or ‘skill.md’), or null if no skill support
Returns
string | null
referencesMode()
referencesMode():
"none"|"directory"|"inline"
Defined in: formatters/src/types.ts:122
How this formatter handles skill references: ‘directory’, ‘inline’, or ‘none’
Returns
"none" | "directory" | "inline"
transformInjectedSkillContent()?
optionaltransformInjectedSkillContent(content):string
Defined in: formatters/src/types.ts:131
Transform the raw content of a pass-through skill file (e.g. the bundled PromptScript SKILL.md injected by the compiler) before it is written to disk. Formatters whose target tools enforce frontmatter schemas (such as Factory AI) can override this to strip unsupported fields.
Defaults to identity when not implemented.
Parameters
content
string
Returns
string