How to use this site

The published website produced by this template framework is designed to allow both humans and machines (AI agents particularly) to read and navigate the skills.

Structure

The skills are placed into categories. Each category can hold as many skills as you wish, but we recommend no more than 10 in each.

A skill has a title, a reference code and then up to seven level descriptors. This approach is based on the same model as has been successfully used by the SfIA skills framework for the past 20 years.

I recommend that you review how the SfIA framework operates - particularly the concept of “levels of responsibility” before starting to work on your own framework.

I have provided the ability to add references to courses. These are linked to specific levels within a skill, so that users can find courses to help them to attain that level.

How humans will use the site

The site can be browsed directly, or users can search for specific terms.

Key pages:

• Skills
• Courses
• Search
• Documentation

For machines and AI agents

All the skills and courses are designed to be consumed easily by machines. The site includes special features to enable machines to walk through and gather the information:

• Stable URLs for skill and course pages
• Canonical, Twitter, OpenGraph and JSON-LD metadata
• Machine-readable endpoints:
  • /skills.json
  • /courses.json
  • /search-index.json
• Discoverability files:
  • /llms.txt
  • /robots.txt
  • /sitemap.xml

You don’t need to worry about these. They are all generated automatically, and agents will know what to do with them.