yard documentation says about @api:
"Does not display in output, but useful for performing queries (+yardoc –query+). Any text is allowable in this tag, and there are no predefined values."

So I think it would be worth putting some text here that will definitely display in the Scope description.