Skip to main content

Creating New Job Specifications with AI

Generate a complete, high-quality specification in minutes by providing context and letting Holly's AI build a comprehensive first draft

Updated over 2 weeks ago

Starting the AI Creation Process

From the main Class Specs dashboard, click "Create new" in the top-right corner, then select "Build with AI." This opens Holly's AI specification generator—a streamlined interface that creates comprehensive job specifications from your input.

What Holly's AI Needs

Holly's AI requires a few key pieces of information to generate your specification:

  • Job Title (required): Official name for the position

  • Role definition (required): Main purpose, key responsibilities, and important details

  • Additional Context: Extra details about organizational specifics and requirements (optional)

  • Files: Upload PDFs for additional context (optional)

  • Salary Range: Minimum and maximum compensation in annual, monthly, bi-weekly, or hourly units (optional)


Providing Effective Input for Generation

Job Title

The job title is essential for the AI to understand exactly what position you're creating. While you can refine it later, starting with an accurate title ensures Holly generates appropriate content from the start and pulls relevant benchmark data.

Role Definition: The More Detail, The Better

Even one sentence is sufficient, but more descriptive information produces better results. The AI expands whatever you provide, so additional detail helps it create more accurate, specific content.

Examples of what to include:

  • Main purpose of the role

  • Key responsibilities and duties

  • Required qualifications or certifications

  • Specific tools, systems, or software used

  • Reporting relationships or team size

  • Organizational context or department focus

Think of it like explaining the role to someone unfamiliar with your organization—provide the context and details they'd need to understand what this job actually does.

Additional Context (Optional)

Use this field for short text instructions and specific requirements. This is also where you can tell the AI how to use any files you've uploaded.

What to include:

  • Specific requirements or organizational terminology

  • Short paragraphs about supervisory responsibilities, physical working conditions, or unique role details

  • Guidance on how to reference uploaded files (e.g., "Follow the qualification format from the uploaded Senior Analyst spec")

  • Particular emphasis areas or sections that need extra attention

For longer content: Upload documents as files in the next section rather than pasting them in.


Files (Optional)

Upload PDFs to give Holly additional context when generating your specification.

What to upload:

  • Existing specifications from your series for consistency

  • Comparable specifications from other jurisdictions

  • Related position descriptions or organizational charts

  • PDQs, interview notes, notes from SMEs

How Holly uses uploaded files: The AI reviews uploaded documents to understand terminology, formatting preferences, and role context specific to your organization. Use the Additional Context field above to provide specific instructions about how to apply information from your uploaded files.

Please note: if you have a PDF of an existing specification that you want to use directly as your draft specification, exit out of the modal, click "Create New" -> "Start from draft" to upload your PDF directly as the base text for your new spec. See Creating a New Specification from Scratch for more guidance.


Salary Range (Optional)

Include minimum and maximum annual salary to have this reflected in the specification.


What Happens When You Click "Generate"

When you click "Generate," Holly creates your specification in 1-2 minutes. The AI generates content designed to score 100% on all quality metrics while incorporating context from benchmark specifications and your organizational template.


Generation and Next Steps

When you click "Generate," Holly creates your specification in 1-2 minutes. The AI:

  • Generates content designed to score 100% on all quality metrics

  • Incorporates context from benchmark specifications in Holly's database

  • Follows your organization's template structure exactly

  • Integrates information from any files you've uploaded

  • Applies your specific instructions and additional context

Your new specification is automatically saved as a Draft, ready for you to review, edit, or refine.


After Generation: Next Steps

Once Holly generates your specification, you can:

  • Review the full draft: Read through each section to ensure accuracy and completeness

  • Edit directly: Click into any section to make manual changes

  • Regenerate specific sections: Use AI to refine individual sections without regenerating the entire document

  • Adjust quality metrics: Address any sections flagged for improvement

  • Compare to benchmarks: See how your specification stacks up against similar positions

  • Share with stakeholders: Send your draft for review and collaboration

  • Continue iterating: Make revisions, track changes, and refine until it's ready for approval


Ready to Customize Your Specification?

Check out our related articles:

Ready to customize your specification? Take a look at our articles on reading and understanding a specification or advanced editing for detailed instructions on manual editing, AI regeneration, prompting tips, and change tracking.

Did this answer your question?